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Preface 

The  Automated  Coastal  Engineering  System  (ACES)  is  being  developed  by  the  Automated 
Coastal  Engineering  (ACE)  Group,  Research  Division  (RD),  Coastal  Engineering  Research  Center 
(CERC),  US  Army  Engineer  Waterways  Experiment  Station  (WES).  Funding  for  the  effort  is  part 
of  the  Coastal  Structures  Evaluation  and  Design  Research  and  Development  Program.  Messrs.  John 
H.  Lockhart,  Jr.,  John  G.  Housley,  Barry  W.  Holiday,  and  David  Roellig  are  the  Technical  Monitors, 
Headquarters,  US  Army  Corps  of  Engineers,  for  this  program. 

Development  of  the  system  was  performed  by  Mr.  David  A.  Leenknecht,  Principal  Investigator 
of  the  ACES,  assisted  by  Mrs.  Ann  R.  Sherlock,  ACE  Group.  Contributors  in  the  development 
were  Miss  Willie  A.  Brandon,  Dr.  Robert  E.  Jensen,  Mr.  Doyle  L.  Jones,  Dr.  Edward  F. 
Thompson,  CERC,  Mr.  Michael  E.  George,  Information  Technology  Laboratory  (ITL),  and  Mr. 
David  W.  Hyde,  Structures  Laboratory,  WES;  former  CERC  employees  who  also  made  contributions 
include  Mr.  John  Ahrens,  National  Oceanic  and  Atmospheric  Administration  Sea  Grant,  Silver 
Spring,  MD;  Dr.  Mark  R.  Byrnes,  Louisiana  State  University,  Baton  Rouge,  LA;  Mr.  Peter  L. 
Crawford,  US  Army  Engineer  (USAE)  District,  Buffalo  (NCB);  Miss  Leslie  M.  Fields,  Aubrey 
Consultants  Incorporated,  Falmouth,  MA;  Mr.  James  M.  Kaihatu,  University  of  Delaware,  Newark, 
DE;  and  Mr.  Kent  A.  Turner,  USAE  Division,  Lower  Mississippi  Valley.  This  report  was  edited 
by  Mrs.  Janean  Shirley,  ITL,  WES. 

The  work  was  performed  under  the  general  supervision  of  Dr.  James  R.  Houston,  Director, 
CERC;  Mr.  Charles  C.  Calhoun,  Jr.,  Assistant  Director,  CERC;.  Ms.  Carolyn  M.  Holmes,  CERC 
Coastal  Program  Manager;  Mr.  H.  Lee  Butler,  Chief,  RD;  and  under  the  direct  supervision  of  Mr. 
Andre  Szuwalski,  Chief,  ACE  Group.  Commander  and  Deputy  Director  of  WES  during  publication 
of  this  guide  was  COL  Leonard  G.  Hassell,  EN.  Dr.  Robert  W.  Whalin  was  the  Director  of  W£S. 

A  Corps-wide  Pilot  Committee  of  coastal  specialists  guides  the  direction  of  the  ACES  effort. 
Members  of  the  ACES  Pilot  Committee  during  this  period  were  Mr.  George  Domurat,  (Chairman), 
USAE  Division,  South  Pacific  (SPD);  Mr.  Dave  Timpy,  (Vice-Chairman),  USAE  -District, 
Wilmington;  Mr.  John  Oliver,  USAE  Division,  North  Pacific;  Mr.  Doug  Pirie,  SPD; „My..  Peter 
Crawford,  NCB;  Mr.  Doug  Gaffney,  USAE  District,  Philadelphia;  Ms.  Cheryl  Ulrich,  USAE  District, 
Mobile;  Mr.  Housley;  and  Dr.  C.  Linwood  Vincent  (CERC). 
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Introduction 


General  Goals  of  the  ACES 

The  Automated  Coastal  Engineering  System  (ACES)  is  an  interactive 
computer-based  design  and  analysis  system  in  the  field  of  coastal  engineering. 
In  response  to  a  charge  by  the  Chief  of  Engineers,  LTG  E.  R.  Heiberg  III,  to 
the  Coastal  Engineering  Research  Board  (US  Army  Engineer  Waterways 
Experiment  Station,  1985)  to  provide  improved  design  capabilities  to  Corps  coastal 
specialists,  the  Coastal  Engineering  Research  Center  (CERC)  conducted  a  series 
of  six  regional  workshops  in  July  1986  to  gather  input  from  Corps  field  offices 
concerning  various  aspects  of  an  ACES.  Subsequent  to  the  workshops,  the  ACES 
Pilot  Committee  and  various  working  committees  were  formed  from  coastal 
experts  throughout  the  Corps,  and  the  Automated  Coastal  Engineering  (ACE) 
Group  was  formed  at  CERC.  The  general  goal  of  the  ACES  is  to  provide 
state-of-the-art  computer-based  tools  that  will  increase  the  accuracy,  reliability, 
and  cost-effectiveness  of  Corps  coastal  engineering  endeavors. 

ACES  Contents 

Reflecting  the  nature  of  coastal  engineering,  methodologies  contained  in  this 
release  of  the  ACES  are  richly  diverse  in  sophistication  and  origin.  The  contents 
range  from  simple  algebraic  expressions,  both  theoretical  and  empirical  in  origin, 
to  numerically  intense  algorithms  spawned  by  the  increasing  power  and 
affordability  of  computers.  Historically,  the  methods  range  from  classical  theory 
describing  wave  motion,  to  expressions  resulting  from  tests  of  structures  in  wave 
flumes,  and  to  recent  numerical  models  describing  the  exchange  of  energy  from 
the  atmosphere  to  the  sea  surface.  In  a  general  procedural  sense,  much  has  been 
taken  from  previous  individual  programs  on  both  mainframes  and 
microcomputers. 

The  various  methodologies  included  in  ACES  are  called  applications  and  are 
organized  into  categories  called  functional  areas  differentiated  according  to 
general  relevant  physical  processes  and  design  or  analysis  activities.  A  list  of 
the  applications  currently  resident  in  the  ACES  is  given  in  the  table  on  the  next 
page. 

Target  Hardware  Environment 

A  strong  preference  expressed  in  the  workshops  and  subsequent  meetings  was 
for  the  system  to  reside  in  a  desktop  hardware  environment.  To  meet  this 
preference,  the  ACES  is  designed  to  reside  on  the  current  base  of  PC-AT  class 
of  personal  computers  resident  at  many  Corps  coastal  offices.  While  expected 
to  migrate  to  more  powerful  hardware  technologies,  this  current  generation  of 
ACES  is  designed  for  the  above  environment  and  is  written  in  FORTRAN  77. 
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Document  Overview 

The  documentation  set  for  the  ACES  comprises  two  manuals:  Technical  Reference 
and  User’s  Guide. 

*  The  Technical  Reference  contains  theory  and  discussion  of  the  various 
methodologies  contained  in  the  ACES.  The  material  included  in  the 
Technical  Reference  is  relatively  brief.  For  essential  features  of 
derivations  and  mathematical  manipulations  of  equations  presented  in 
each  section  of  this  manual,  the  reader  is  strongly  directed  to  references 
presented  at  the  end  of  each  application  description. 

*  The  User’s  Guide  contains  instructions  for  using  individual  applications 
within  the  ACES  software  package. 


(  Current  ACES  Applications  ! 

Functional  Area 

Application  Name 

Wave 

Prediction 

Windspeed  Adjustment  and  Wave  Growth 

Beta-Rayleigh  Distribution 

Extremal  Significant  Wave  Height  Analysis 

Constituent  Tide  Record 

1  Wave  Theory 

Linear  Wave  Theory 

Cnoidal  Wave  Theory 

Fourier  Series  Wave  Theory 

W  ave 

Transformation 

Linear  Wave  Theory  with  Snell's  Law 

Irregular  Wave  Transformation  (Goda's  method) 

Combined  Diffraction  and  Reflection  by  a  Vertical  Wedge  ; 

Structural 

Design 

Breakwater  Design  Using  Hudson  and  Related  Equations 

Toe  Protection  Design 

Nonbreaking  Wave  Forces  on  Vertical  Walls 

Rubble- Mound  Revetment  Design 

Wave  Runup, 
Transmission,  and 
Overtopping 

Irregular  W ave  Runup  on  Beaches 

Wave  Runup  and  Overtopping  on  Impermeable  Structures 

Wave  Transmission  on  Impermeable  Structures 

Wave  Transmission  Through  Permeable  Structures 

Littoral 

Processes 

Longshore  Sediment  Transport 

Numerical  Simulation  of  Time-Dependent  Beach  and  Dune  Erosion 

Calculation  of  Composite  Grain-SUe  Distribution 

Beach  Nourishment  Overfill  Ratio  and  Volume 

Inlet  Processes 

A  Spatially  Integrated  Numerical  Model  for  Inlet  Hydraulics 
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US  Army  Engineer  Waterways  Experiment  Station.  1985.  Proceedings  of  the 
44th  Meeting  of  the  Coastal  Engineering  Research  Board ,  4-6  November 
1985,  Sausalito,  California,  James  R.  Houston,  Editor,  Vicksburg,  MS, 
pp.  11-21. 
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User  Interface 

This  version  of  the  Automated  Coastal  Engineering  System  (ACES)  employs  a 
menu-driven  environment.  Menus  are  displayed  on  the  screen,  and  in  general, 
single  keystrokes  (usually  the  (fI)- frlo)  function  keys)  are  required  to  select 
activities  or  options  in  the  system.  Cursor  keys  are  used  to  select  between 
highlighted  input  fields  (displayed  in  reverse  video).  Some  applications  allow 
input  through  data  saved  in  an  external  file.  Results  from  computations  are 
normally  displayed  in  tabular  format  on  the  screen  and/or  written  to  print' files 
or  devices  and/or  displayed  as  plots.  Appendix  D  is  a  summary  table  listing  the 
input  and  output  options  for  the  applications  available  in  this  version  of  ACES. 

Starting 

Appendix  B  provides  installation  instructions  for  the  ACES  software  including 
graphics  options.  (Appendix  C  specifically  discusses  the  graphics  options.)  The 
installation  procedure  described  in  Appendix  B  suggests  copying  the  ACES  files 
into  a  subdirectory  called  ACES107.  To  begin  a  session: 

1.  Type  CD\ACES107  and  press  I  enter  1. 

2.  Type  ACES  and  press  [  enter  ]. 

The  Main  Menu  of  ACES  is  displayed,  and  single  keystrokes  become  the  primary 
selection  mechanism  for  the  session. 


Ending 

From  any  point  in  the  system,  repeated  use  of  the  fFio)  key  returns  to  successively 
higher  menu  levels  and,  ultimately,  back  to  DOS.  Exceptions  occur  when  lengthy 
computations  are  in  progress  (they  must  be  allowed  to  finish)  and  when  incorrect 
data  have  been  specified  in  interactive  input  fields  (valid  data  must  be  respecified). 

Definitions  > 

An  individual  methodology  included  in  the  system  is  called  an  application  and 
is  assigned  to  a  functional  area  according  to  its  general  end  product.  An  operational 
mode  (Single  or  Multiple  Case)  describes  the  type  of  general  activity  or  type  of 
input  associated  with  a  given  session.  This  information  is  displayed  on  the  screen 
while  applications  are  executed  in  the  system. 
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Modes 

The  Main  Menu  of  ACES  provides  access  to  two  (with  some  exceptions)  separate 
operational  modes: 

Option  Main  Activity  (Model 

(fT)  Single  Case  Mode 

(F2)  Multiple  Case  Mode 

It  also  provides  an  [fio]  option  to  exit  the  system.  Each  of  the  modes  is  discussed 
below. 

Single  Case  Mode  Execution 

This  is  one  of  the  two  execution  modes  requiring  active  participation  with  an 
application.  From  the  Functional  Area  Menu,  a  specific  application  is  selected 
from  successive  menus.  Data  for  a  single  case  are  specified  by  moving  the  cursor 
to  highlighted  data  input  fields  and  specifying  the  value;  results  are  displayed 
on  the  screen  and  can  optionally  be  sent  to  a  print  file  or  device.  Errors  are 
identified,  and  recovery  by  respecification  of  the  data  is  allowed.  Successive 
execution  with  new  values  (all  or  individual  data  items  ...  called  a  new  case)  is 
an  option. 


Multiple  Case  Mode  Execution 

Like  Single  Case  Mode,  this  execution  mode  is  interactively  selected  from 
successive  menus  and  also  requires  active  participation  with  an  application,  but 
allows  specification  of  sets  of  data  values  for  most  input  variables.  Sets  of  data 
are  specified  by  declaring  a  range  of  values  (minimum,  maximum,  and  increment) 
or  up  to  20  discrete  values  for  each  variable  in  highlighted  fields  on  the  display 
screen.  After  entry  of  all  sets  of  data  (for  all  input  variables),  the  permutations 
of  the  data  sets  are  processed  as  discrete  cases.  Intended  primarily  for  performing 
sensitivity  or  economic  analysis,  the  Multiple  Case  Mode  provides  a  powerful 
mechanism  for  looking  at  the  effects  of  ranges  of  data.  Execution  results  are 
written  to  the  print  file  or  device  only. 

CAUTION:  Care  should  be  taken  to  process  a  reasonable  number 
of  cases.  (For  convenience,  the  total  number  of  cases  to  be 
processed  is  displayed.)  There  are  no  limits  imposed  by  the  system 
to  the  number  of  cases  possibly  generated  by  using  an  incremental 
specification. 


NOTE:  The  most  effective  way  to  use  the  Multiple  Case  Mode 
is  to  pick  one  parameter  and  assign  it  multiple  values,  and  assign 
only  one  value  to  the  remaining  parameters. 
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Exceptions 

Not  all  applications  will  have  access  to  both  operational  modes.  There  are  a 
number  of  applications  that  allow  only  a  Single  Case  Mode.  In  these  applications, 
the  Single  Case  Mode  will  normally  have  two  options  of  interaction.  The  first 
option  allows  entering  initial  or  new  data  as  described  above.  The  second  option 
allows  direct  editing  of  a  previously  created  data  file  for  the  particular  application 
(see  section  entitled  Trace  Output  File). 


General  Data  Specifications 

For  a  given  session,  the  information  listed  below  is  considered  constant  for  all 
activities  and  is  specified  only  once  after  selection  of  an  operational  mode  from 
the  Main  Menu. 


System  of  Units 

This  item  refers  to  the  general  system  of  units  in  which  results  are  displayed 
and  printed  (US  Customary  or  Metric).  Input  variables  are  permitted  many 
units,  but  final  summaries  are  reported  in  the  selected  system  of  units. 
Specific  units  for  each  variable  are  itemized  in  the  documentation  for  each 
application.  The  default  is  US  CUSTomary. 

NOTE:  The  terms  US  Customary  and  English  units  are  used 
interchangeably  in  this  document. 


General  Water  Type 

Choose  between  sea  or  fresh  water.  Average  fluid  properties 

are  assumed  based  upon  this  specification.  The  default  is  SEA  water. 

Title 

A  65-character  title  block  is  provided  for  unique  identification  of  results 
from  a  given  session.  This  title  block  is  printed  as  part  of  the  page  banner 
(under  the  Project  heading)  on  printed  output. 

Print  File/Device 

Specify  the  name  of  the  target  DOS  device  or  file  name  (including  directory 
•  path)  for  all  output  selected  for  printing.  The  default  is  LPT1. 

NOTE:  All  file  (including  directory  path)  and  device  names  are 
restricted  to  20  characters. 
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Page  Ejects 

When  running  in  Single  Case  Mode,  the  printer  can  be  forced  to  print  the 
output  results  of  each  application  processed  on  a  separate  page.  This  could 
use  much  paper  if  many  cases  are  processed.  The  default  is  NO  page 
ejects. 

Files 

A  number  of  input  and  output  files  are  handled  by  the  system.  File  overwrite 
protection  is  provided  by  the  ACES  package  with  optional  overrides  offered  to 
the  user  for  existing  files;  actual  file  names  should  be  specified  for  maximum 
protection  and  efficiency.  Specific  input  and  output  files  are  discussed  below. 


Trace  Output  File 

Certain  applications  allow  input  via  an  existing  file.  These  same  applications 
also  record  the  history  of  input  during  a  session  by  writing  the  input  data 
to  a  file.  Any  valid  DOS  file  name  (including  directory  path)  may  be 
specified  for  this  file.  The  default  file  is  named  TRACE. OUT.  If  the 
file  TRACE  .OUT  already  exists,  a  warning  message  is  displayed  at  the 
bottom  of  the  screen.  The  following  file-handling  options  are  then 
displayed  and  available: 


[Fp  Replace  it. 

Existing  data  in  the  TRACE.OUT  file  will  be  deleted 
and  a  new  TRACE.OUT  file  created. 

(F2)  Choose  another  file. 

This  option  allows  the  user  to  rename  the  TRACE.OUT 
file,  thus  saving  the  data  created  in  an  earlier  session. 

Any  valid  DOS  file  name  (including  directory  path) 
may  be  specified. 

(ED  Append  output  to  it. 

This  option  will  append  any  input  during  the  present 
session  to  the  existing  TRACE.OUT  file. 

[Flo]  Return  to  previous  menu. 

Plot  Output  Files 

These  files  will  contain  output  data  generated  by  certain  applications.  The 
files  can  then  be  used  outside  the  ACES  environment.  The  specific  content 
and  format  of  these  files  are  described  in  the  section  of  this  manual  that 
describes  the  application  which  generates  them.  Default  names  are 
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PLOTDAT1  .OUT,  PLOTD AT2 .OUT,  PL0TDAT3.0UT.  If  any  of  these 
files  already  exist  when  an  ACES  session  is  begun,  a  warning  message  is 
displayed  at  the  bottom  of  the  screen,  and  the  same  file-handling  options 
that  were  available  for  the  TRACE.OUT  file  are  then  displayed. 


Defaults 

Default  values  appear  in  the  data  fields  of  many  applications  in  Single  Case 
Mode.  These  values  are  for  demonstration  purposes  only.  Actual  data  should 
always  be  specified  for  variables  in  the  applications.  After  the  first  execution 
of  an  application  within  a  session,  data  are  retained  from  case  to  case  until 
changed. 


Errors 

Errors  are  reported  on  the  display  screen,  but  corrected  differently  for  the  two 
execution  modes.  In  general,  errors  may  be  corrected  in  Single  and  Multiple 
Case  Modes. 
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Windspeed  Adjustment  and  Wave  Growth 


Description  v 

The  methodologies  presented  in  this  ACES  application  provide  quick  and  simple 
estimates  for  wave  growth  over  open-water  and  restricted  fetches  in 'deep  and 
shallow  water.  Also,  improved  methods  (over  those  given  in  the  Shore  Protection 
M cmual  (SPM),  1984)  are  included  for  adjusting  the  observed  winds  to  those 
required  by  wave  growth  formulas.  Because  of  the  complexity  of  this  methodology 
and  the  input  requirements,  familiarization  with  the  Technical  Reference  for  this 
application  is  strongly  recommended.  •'  . 

Procedure  1  " 

This  section  provides  instructions  for  running  this  application  in  the  Single  Case 
and  Multiple  Case  modes,  ( 

■■■  5  '  '•  '  I 

Single  Case  Mode 

The  bulleted  items  listed  below  provide  instructions  for  accessing  the  application. 

°  Press  (Fl)  on  the  Main  Menu  to  select  Single  Case  Mode. 

°  Fill  in  the  highlighted  input  fields  on  the  General  Specifications 

screen  (or  leave  the  default  values).  Press  (fi)  when  all  data  bn 
this  screen  are  correct. 

°  Press  (fT)  on  the  Functional  Area  Menu  to  select  Wave  Prediction. 

Press  (fi)  on  the  Wave  Prediction  Application  Menu  to  select 
Windspeed  Adjustment  and  Wave  Growth,  / 

Input 

For  the  Single  Case  Mode,  data  input  for  this  application  is  accomplished  through 

one  main  input  screen,  plus  some  support  screens  (for  restricted  fetch  geometry), 

and  several  pop-up  windows  (hereafter  called  requestors  in  this  document)  that 
request  additional  specific  data  or  choices  between  menu-style  items.  These  are 
described  in  the  following  section.  , 
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Main  Input  Screen 


The  main  input  screen  for  the  Single  Case  Mode  is  shown  in  Figure  1-1-1.  It 
is  used  for  entering  data  values  and  corresponding  units  for  six  specific 
parameters ,  and  choosing  between  six  Wind  Observation  Types  and  two  Wind 
Fetch  Options.  Final  results  from  the  computations  are  displayed  on  this  screen. 


Item 

Value 

Unite 

El  of  Observed  Wind 

Z0bs:  ? 

? 

Observed  Wind  Speed 

Uobs:  ? 

? 

Air  Sea  Temp.  Diff. 

AT:  ? 

? 

Dur  of  Observed  Wind 

DurO:  ? 

? 

Dur  of  Final  Wind 

DurF:  ? 

? 

Lat.  of  Observation 

LAT:  1 

deg 

Wind  Fetch  Length 

F: 

Eq  Neutral  Wind  Spd 

Ue: 

Adjusted  Wind  Speed 

Ua: 

Wave  Height 

Hmo: 

Wavfl  Period 

Tp: 

sec 

Wave  Growth: 


i 

Wind  Obs  Type 

Overwater  (ship) 
Overwater 

Shore  (windward) 
Shore  (leeward) 
Inland 
Geostrophic 

4. 

Wind  Fetch  Options 

Open  Water 

Restricted 

Options: 

FI:  Proceed 

F10:  Exit  Applic 


Figure  1-1-1.  Main  Input  Screen  -  Single  Case  Mode 


Specific  Parameters 

The  following  list  describes  the  specific  input  parameters  on  the  main  input 
screen  (indicated  by  ?  in  Figure  1  —  I  - 1 )  with  corresponding  units  and  range  of 
data  recognized  by  this  application: 


Item 

Svmbol 

Units 

Data  Ranee 

Elevation  of  observed  wind 

Zobs 

ft,  m 

1.0 

to 

5000.0 

Observed  wind  speed 

tfobs 

ft/sec,  mph, 
m/sec,  knots 

0.1 

to 

200.0 

Air-sea  temperature  difference 

AT 

°C,  °F 

-100.0 

to 

100.0 

Duration  of  observed  wind 

DurO 

hr,  min,  sec 

0.1 

to 

86400.0 

Duration  of  final  wind 

DurF 

hr,  min,  sec 

0.1 

to 

86400.0 

Latitude  of  wind  observation 

LAT 

deg 

0.0 

to 

180.0 
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Wind  Observation  Type 

Select  a  Wind  Observation  Type  by  moving  the  cursor  to  the  desired  type  and 
pressing  Q.  The  options  available  are: 

Location  of  Observation  Wind  Direction 

Over  water  (shipboard) 

Over  water  (not  shipboard) 

At  shoreline  (windward)  Offshore  to  onshore 

At  shoreline  (leeward)  Onshore  to  offshore 

I  '  Over  land 

Geostrophic  ■  '  ’ 


Wind  Fetch  Options 

Select  a  Wind  Fetch  Option  by  moving  the  cursor,  to  the  desired  option  and 
pressing  The  options  available  are: 

°  Open  Water 
°  Restricted  (Fetch) 

Selecting  either  of  these  options  will  display  requestors  for  further  input.  The 
format  and  data  requirements  of  these  requestors  are  described  below. 
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Open-Water  Wave  Growth  Equations  Requestor 

The  Open-Water  Wave  Growth  Equations  requestor  for  the  Single  Case  Mode  is 
shown  in  Figure  1-1-2.  It  requests  choosing  between  the  deep-  and  shallow- water 
wave  growth  equations  and  values  for  the  length  and  units  of  wind  fetch. 


Open  Water  Wave  Growth  Eqs 

Deep 

Shallow 

T 

t 

Place  x  next 
to  choice 

Open  Water  Fetch  Input 

Length  of  Wind  Fetch:  ?  ? 


Options: 

FI:  Accept  wave  eq  selection  and  fetch 
and  return  to  main  screen 
Alt+FIQ:  Exit  application 

Figure  1-1-2.  Open-Water  Requestor  -  Single  Case  Mode 

Select  a  Wave  Growth  Equation  by  moving  the  cursor  to  the  desired  type  and 
pressing  The  options  available  are: 

°  Deep  (deepwatei  wave  growth  relationships). 

0  Shallow  (shallow-water  wave  growth  relationships). 

When  the  Shallow  option  is  chosen,  another  requestor  will  appear  on  the  screen 
asking  for  the  value  and  units  of  the  average  depth  of  the  fetch.  See  the  section 
titled  Average  Depth  of  Fetch  Requestor  and  Figure  1-1-3  for  more  details. 

The  following  list  summarizes  the  requested  input  (indicated  by  ?  in  Figure 
1-1-2)  for  the  Open- Water  Wave  Growth  Equations  requestor.  The  list  identifies 
the  specific  input  parameter,  units,  and  range  of  data  recognized  by  this 
application: 

Item  Symbol  Units  Data  Range 

Length  of  wind  fetch  F  ft,  m,  mi,  km  0.0  to  9999.0 

When  all  data  on  the  Open-Water  Wave  Growth  Equations  requestor  are  correct, 
press  one  of  the  folloiving  keys  to  select  the  appropriate  action: 

(fT)  Accept  wave  eq  selection  and  fetch  and  return  to  main  screen. 
[Ait)  [fio)  Exit  application. 
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Average  Depth -of  Fetch  Requestor 

■  ■  '  . .  -f.  •  >■  •  ; 

The  Average  Depth  of  Fetch  requestor  is  shown  in  Figure  1-1-3  and  appears 
when  the  shallow-water  wave  growth  equations  are  selected. 


Avg  Depth  of  Fetch  d:  ?  ? 


Options: 

FI:  Accept  avg  fetch  depth  data  and 
return  to  previous  window 
Alt+FlO:  Exit  application 


Figure  1-1-3.  Average  Depth  of  Fetch  Requestor  -  Single  Case  Mode 


The  following  list  summarizes  the  requested  input  (indicated  by  ?  in  Figure 
1-1-3)  for  this  requestor.  The  list  identifies  the  specific  input  parameter,  units, 
and  range  of  data  recognized  by  this  application:  / 


■(. 


Item  ..  * 

Average  depth  of  fetch 


Symbol  Units 
d  <  •  ft,  m 


Data  Range 
0.1  to  10000.0 


When  the  data  for  this  requestor  are  correct,  press  one  of  the  following  keys  to 
select  the  appropriate  action: 

•*  »  .  ■  *  *.  • 

(fi)  Accept  avg  fetch  depth  data  and  > 

return  to  previous  window. 


(Ait)  (fio)  Exit  application. 


..Restricted  Fetch  Requestor 

The  data  requirements  for  the  Restricted  Fetch  approach  are  substantially  larger 
than  the  simpler  Open-Water  fetch  approach.  In  addition  to  choosing  between 
the  deepwater  and  shallow-water  wave  growth  equations,  the  wind  approach 
direction  must  be  specified  as  well  as  an  accurate  description  of  the  geometry 
of  the  subject  basin.  Radial  fetch  lengths  measured  (clockwise  from  north)  from 
the  point  of  interest  are  used  to  describe  the  geometry  of  the  basin.  The 
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conventions  and  notations  associated  with  data  solicited  by  this  group  of  requestors 
as  well  as  the  remainder  of  the  data  for  the  Fetch  Geometry  Data  Entry  Screen 
which  follows  are  presented  in  Figure  1-1-4, 


Fetch, 


Fetchj 


Figure  1-1-4.  Restricted  Fetch  Conventions 


The  Restricted  Fetch  requestor  for  the  Single  Case  Mode  is  shown  in  Figure 
1-1-5.  It  requests  a  value  for  the  wind  approach  direction  and  a  choice  between 
the  deepwater  and  shallow-water  wave  growth  equations.  It  also  requests  a  choice 
between  entering  all  of  the  fetch  geometry  interactively  or  reading  the  fetch 
geometry  from  a  data  file. 


Restricted  Fetch 

Wind  Direction 

a  ;  ?  deg 

Fetch  Geometry 
Input  Options 

Keyboard 

Data  File 

i 

Wave  Growth 

Equations 

Deep 

Shallow 

t  t 

Place  x  on  desired  choice 


Options: 

Ft:  Accept  these  data  and 
return  to  main  screen 
Alt+FlO:  Exit  Application 


Figure  1-1-5.  Restricted  Fetch  Requestor  -  Single  Case  Mode 


The  following  list  summarizes  the  requested  input  (indicated  by  ?  in  Figure 
1-1-5)  for  the  Restricted  Fetch  requestor.  The  list  identifies  the  specific  input 
parameter,  units,  and  range  of  data  recognized  by  this  application: 

Item  Symbol  Units  Data  Ranee 

Wind  Direction  a  deg  0  to  360 
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Next,  select  a  Wave  Growth  Equation  by  moving  the  cursor  to  the  desired  type 
and  pressing  ®.  The  options  available  are: 

°  Deep  (deepwater  wave  growth  relationships). 

0  Shallow  (shallow- water  wave  growth  relationships). 

When  the  Shallow  option  is  chosen,  another  requestor  will  appear  on  the  screen 
requesting  the  average  depth  of  the  fetch.  See  the  section  titled  Average  Depth 
of  Fetch  Requestor  and  Figure  1-1-3  for  data  input  details. 


option  and  pressing  The  options  available  are: 


Keyboard  (geometry  keyed  in  now). 
Data  File  (geometry  read  from  file). 


format  and  data  requirements  of  these  requestors  are  described  below. 


Keyboard  Data  Entry  Requestor  X  J  •;  ' 

The  Keyboard  Data  Entry  requestor  is  shown  in  Figure  1-1-6. 


.Restricted  Fetch  Geometry  Input  ■ 

Radial  Angle  Increment 
Diroflst  Radial  Fetch  p,  :  .  ?  ; 

•  ^  .  Nc  of  Radial  Fetches  Nfet:  ? 

Options:  • 

Alt+Fl:  Display  radial  fetch  lengths 
F10:  Return  to  previous  window 
Alt+FlO:  -Exit  application 

Figure  1-1-6.  Keyboard  Data  Entry  Requestor  -  Single  Case  Mode 

The  following  list  summarizes  the  requested  input  (indicated  by  ?  in  Figure 
1-1-6)  for  the  Restricted  Fetch  Keyboard  Data  Entry  requestor:  The  list  identifies 
the  specific  input  parameter,  units,  and  range  of  data  recognized  by  this 
application:  > 
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Item 

Svmbol 

Units 

Data 

Ranee 

Radial  Angle  Increment 

A  p 

deg 

1.0 

to 

180.0 

Dir  of  1st  Radial  Fetch 

P. 

deg 

0.0 

to 

360.0 

NOTE:  is  measured  clockwise  from  north. 

No  of  Radial  Fetches  Nfet  2  to  360 

NOTE:  The  total  angular  coverage  of  the  radials  must 
not  exceed  360  deg. 

When  the  data  on  this  requestor  are  correct,  press  one  of  the  following  keys  to 
select  the  appropriate  action: 

[Alt]  [Fl)  Display  radial  fetch  lengths. 

(fio)  Return  to  previous  window. 

(Ait)  [fio)  Exit  application. 

When  the  (Ait)  [Fij  option  is  selected,  a  Fetch  Geometry  Data  Entry  Screen 
(described  below)  will  appear  to  allow  input  of  fetch  lengths. 


Fetch  Geometry  Data  Entry  Screen 

The  majority  of  the  data  describing  the  restricted  fetch  geometry  are  collected 
on  this  data  entry  screen.  A  total  of  Nfet  individual  radial  fetch  lengths  must 
be  provided  at  their  corresponding  angles  (measured  clockwise  from  north  and 
prescribed  by  0i  ,  A  (3).  The  radial  fetch  index  numbers  and  corresponding  angles 
are  displayed  as  an  input  aid  on  this  screen.  The  units  and  allowed  range  of 
radial  fetch  values  considered  by  this  application  are  tabulated  below: 

Item 

Fetch  Length 


Symbol  Units  Data  Ranee 

ft,  m,  mi,  km  0.0  to  9999.0 
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Up  to  20  values  may  be  input  and  displayed  on  this  screen.  If  more  that  20 
radial  fetch  values  are  specified  ( Nfet  >  20),  the  screen  will  subsequently  be 
re-invoked  for  the  next  20  values  and  so  on.  When  the  data  on  this  screen  are 
correct.  Dress  one  of  the  following  keys  to  select  the  appropriate  action: 

[fT  Accept  data. 

NOTE:  The  next  20  values  may  then  be  input  when  the 
,  screen  is  re-invoked  in  this  fashion.  If  all  (Nfet)  values 
for  radial  fetch  length  have  been  specified,  this  action 
will  signify  acceptance  of  the  data  as  entered  and  return 
;  to  the  main  input  screen  (Figure  1-1-1). 

[a  it)  [Flo]  Exit  application. 


Data  File  Entry  Requestor 


As  an  alternative  to  interactively  keying  in  the  restricted  fetch  geometry  data, 
a  data  file  containing  the  information  may  be  specified.  This  requestor  provides 
a  mechanism  for  declaring  the  name  of  the  data  file  which  contains  the  restricted 
fetch  geometry.  The  format  of  the  Data  File  Entry requestor  is  shown  in  Figure 
1-1-7. 


Data  File  Name:  WAWG.IN 


Options:  fr .. 

Alt+Pt:  Rcad’the  data  file  now 
F10:  Return  to  previous  window 
Alt+FlO:  Exit  Application 


Figure  1-1^7.  Data  File  Entry  Requestor  -  Single  Case  Mode 


Use  this  requestor  to  access  and/or  modify  fetch  geometry  data  saved  in  an 
external  file.  Typically  this  data  file  has  been  created  with  a  tetft  editor  or  saved 
as  a  trace  file  (default  name  TRACE.Olil)  from  a  previous  execution  of  this 
application.  The  format  and  contents  of  a  trace  file  produced  by  this  application 
match  exactly  the  requirements  of  this  input  file.  The  default  input  file  name 
is  WAWG.IN,  but  other  filenames  (including  pathname)  are  acceptable.  For 
more  information  on  files,  see  the  section  of  this  manual  entitled,  General 
Instructions  and  Information.  •  .  ' 
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After  specifying  the  name  of  the  file,  press  one  of  the  following  keys  to  select 
the  appropriate  action: 

[Ait]  (fT)  Read  the  data  file  now. 

NOTE:  Use  this  option  to  open  and  read  the  data  file 
at  this  time.  Upon  successfully  reading  the  file,  the 
Fetch  Geometry  Data  Entry  Screen  is  displayed  and 
shows  the  restricted  fetch  geometry  read  from  the  file. 

The  data  may  then  be  edited  or  accepted  using 
procedures  described  in  the  previous  section. 

(fio)  Return  to  previous  window. 

NOTE:  Use  this  option  to  return  to  the  previous  window 
without  accepting  any  fetch  geometry  data. 

[Ait)  (fI)  Exit  application. 


Finally,  the  application  is  executed  with  the  selected  options  and  data  by  pressing 
(fi)  from  the  main  input  screen  (Figure  1-1-1).  Input  and  output  data  are 
displayed  on  the  screen  using  the  original  units  for  related  parameters.  The  one 
exception  is  the  wave  height  which  is  reported  in  the  final  system  of 

units.  The  following  section  entitled  Output  summarizes  the  parameters  generated 
by  this  application. 

After  completion  of  the  computations,  press  one  of  the  following  keys  to  select 
the  appropriate  action: 

[fi]  Solve  a  new  case. 

(F3)  Send  a  summary  of  this  case  to  the  print  file  or  device. 

[fio]  Exit  this  application  and  return  to  the  Wave  Prediction 
Application  Menu. 
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Output 


Results  from  this  application  are  displayed  on  the  main  input  screen  in  Single 
Case  Mode.  The  report  also  includes  the  Original  input  values.  The  following 
data  are  always  reported:  ' 


.7  '  ■  ■■■  . 

Item  ;  : 

SVmbol 

English 
•  Units 

Metric 

Hn its 

Equivalent  neutral  wind  speed 

;  ue  - 

ft/sec,  mph, 
knots 

m/sec 

Adjusted  wind  speed 

'  <V 

ft/sec,  mph, 
knots 

m/sec 

Wave  height 

H  m  ’o 

/C.V:  ft  :Sr 

m. 

Peak  wave  period 

T 

:  p  K-  : 

■  sec  ■ 

sec 

In  addition  to  the  above  output,  a  message  is  provided  indicating  whether  deep- 
or  shallow  water  equations  were  employed  and  whether  the  wave  growth  was 
ultimately  determined  by  fetch-limited,  duration-limited,  or  fully  developed 
criteria.-  '  ; 

If  the  restricted  .fetch  approach  was  selected,  the  individual  radial  fetch  data  are 
not  reported  as  output.  However,  the  resultant  maximized  fetch  as  well  as 
directional  data  for  wind  and  wave  growth  are  also  displayed: 

Item 

Svmbol 

English 

Units 

Metric 

Units 

Fetch  Length  . . 

•  '  V 

rjif.  ft,  mi  - 

m,  km 

Wind  Direction  ;v*r  .• . 

a 

••••  deg  ; 

deg 

Wave  Direction 

0 

•  deg 

deg 

:•  £'.  ■  '  ' 

.  \  7  ’  ,  ‘  •  ‘  ;• 

•  •  '  '  : 
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Multiple  Case  Mode 

The  bulleted  items  listed  below  provide  instructions  for  accessing  the  application. 
°  Press  (F2]  on  the  Main  Menu  to  select  Multiple  Case  Mode. 

0  Fill  in  the  highlighted  input  fields  on  the  General  Specifications  screen 
(or  leave  the  default  values).  Press  (fT)  when  all  data  on  this  screen 
are  correct. 

0  Press  (fi|  on  the  Functional  Area  Menu  to  select  Wave  Prediction. 

°  Press  (fi)  on  the  Wave  Prediction  Application  Menu  to  select  Windspeed 
Adjustment  and  Wave  Growth. 

Input 

As  in  most  ACES  applications,  the  data  requirements  for  the  Multiple  Case  Mode 
are  essentially  the  same  as  for  Single  Case  Mode,  but  are  organized  in  a  different 
fashion:  Data  entry  is  accomplished  through  several  screens  and  requestors  which 
are  described  in  the  following  sections. 


Main  Input  Screen 

The  main  input  screen  for  the  Multiple  Case  Mode  is  shown  in  Figure  1-1-8. 
It  facilitates  choosing  a  Wind  Observation  Type  and  Wind  Fetch  Option  for  all  of 
the  computations  which  follow. 


Type  of  Observation 

Wind  Direction 

Over  Water  (shipboard) 

Over  W  ater 

Shoreline  (windward) 

Offshore  -  >onshore 

Shoreline  (leeward) 

Onshore->offshore 

Over  Land 

Geostrophic 

Wind  Fetch  Options 

Open  Water 

Restricted 

Place  x  next  to  choice  Options: 

FI:  Proceed 

F10:  Exit  Application 

Figure  1-1-8,  Main  Input  Screen  -  Multiple  Case  Mode 
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Wind  Observation  Type  ;■ 

Select  a  Wind  Observation  Type  by  moving  the  cursor  to  the.  desired  type  and 
pressing  The  options. available  are: 

Location  of  Observation  Wind  Direction 

Over  water  (shipboard) 

Over  water  (not  shipboard) 

At  shoreline  (windward)  -  Offshore  to  onshore 
At  shoreline  (leeward)  Onshore  to  offshore 

Over  Land  / 

Geostrophic 

Wind  Fetch  Options 

Select  a  Wind  Fetch  Option  by  moving  the  cursor  to  the  desired  option  and 

pressing  (x).  Two  options  are  available: 

°  Open  Water  '• '  ■  i- 

°  Restricted  (Fetch) 

Selecting  either  of  these  options  will  display  appropriate  requestors  for  further 
input.  The  format  and  data  requirements  of  these  requestors  are  described  below. 


Open-Water  Wave  Growth  Equations  Requestor 

The  Open- Water  Wave  Growth  Equations  requestor  for  the  Multiple  Case  Mode 
is  shown  in  Figure  1-1-9.  It  provides  a  mechanism  for  choosing  between  the 
deepwater  and  shallow-water  wave  growth  equations. 


Open  Water  Wave  Growth  Eqs 

Deep 

Shallow 

t 

T 

Place  x  next 

to  choice 


Options: 

FI:  Accept  wave  eq  selection  and 
return  to  main  screen 
Alt+FlO:  Exit  application 

Figure  1-1-9.  Open-Water  Requestor  -  Multiple  Case  Mode 
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Select  a  wave  growth  equation  by  moving  the  cursor  to  the  desired  type  and 
pressing  (x).  Two  options  are  available: 

°  Deep  (deepwater  wave  growth  relationships). 

“  Shallow  (shallow-water  wave  growth  relationships). 


After  selecting  a  wave  growth  equation,  press  (fT)  to  return  to  the  Multiple  Case 
Mode  main  input  screen  (Figure  1-1-8)  and  press  (fT)  to  bring  up  the  specific 
parameters  data  entry  screen. 


Restricted  Fetch  Requestor 

The  Restricted  Fetch  requestor  for  the  Multiple  Case  Mode  is  shown  in  Figure 
1-1-10.  It  requests  a  choice  between  the  deepwater  and  shallow-water  wave 
growth  equations  and  a  choice  for  the  preferred  mode  of  entering  data  for  the 
restricted  fetch  geometry. 


i 

Wave  Growth 
Equations 

Deep 

Shallow 

J, 

Fetch  Geometry- 
Input  Options 

Keyboard 

Data  File 

T  T  Place  x  next  to 

choice 

Options: 

FI:  Accept  these  data  and  return 
to  main  screen 
AJt+FlO:  Exit  Application 

Figure  1-1-10.  Restricted  Fetch  Requestor  -  Multiple 
Case  Mode 


Select  a  Wave  Growth  Equation  by  moving  the  cursor  to  the  desired  type  and 
pressing  (x).  Two  options  are  available: 

°  Deep  (deepwater  wave  growth  relationships). 

°  Shallow  (shallow-water  wave  growth  relationships). 
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Finally,  select  a  Fetch  Geometry  Input  Option  by  moving  the  cursor  to  the  desired 
option  and  pressing  The  options  available  are: 

°  Keyboard  (geometry  keyed  in  now). 

°  .  Data  File  (geometry  read  from  a  file). 

Selecting  either  of  these  options  will  display  requestors  for  further  input.  The 
two  corresponding  requestors  (Keyboard  Data  Entry  and  Data  File  Entry)  have 
been  described  in  the  Single  Case  Mode  portion  of  this  document.  Refer  to 
Those  earlier  sections  for  details.  . 


After  completing  input  on  the  requestors,  return  to  the  main  input  screen  (Figure 
1-1-8)  and  press  (fi)  to  proceed  to  the  specific  parameters  data  entry  screen  and 
follow  the  steps  outlined  below  for  entering  data  on  this  screen. 


Specific  Parameters  Data  Entry  Screen 


Move  the  cursor  to  select  a  variable  on  this  screen  (the  selected  variable  name 
blinks).  The  current  set  of  values  for  the  variable  is  displayed  on  the  right 
portion  of  the  screen.  When  all  variable  sets  are  correct,  go  to  Step  3. 

Enter  a  set  of  values  for  the  subject  variable  by  following  one  of  the  input 
methods:  v!  ■  ‘ 

a.  Press  (r)  to  select  random  method.  Enter  up  to  20  values  constituting 

a  set  for  this  variable  (one in  each  field)  oh  the  right  side  of  the  screen. 
The  set  of  20  values  originally  displayed  (first  execution)  in  these  fields 
contains  the  "delimiting"  value,  which  "delimits"  or  "ends"  the  set.  The 
"delimiting"  value  is  not  included  as  a  member  in  the  set  unless  it  is 
the  sole  member/  *  '-‘y’"-'' 

b.  Press  (T)  to  select  incremental  method.  Fill  in  the  fields  for  minimum, 
maximum,  and  increment  values  for  this  variable  on  the  right  side  of 
the  screen.  In  this  method,  the  members  of  the  set  include  all  values 
from  the  minimum  to  the  maximum  (both  inclusive)  at  the  specified 

.  V  increment.  '  •...] 
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The  units  field  should  also  be  specified  for  the  variable  regardless  of  input 
method.  All  members  of  a  set  of  values  for  a  subject  variable  are  assigned 
the  specified  units.  When  all  data  are  correct  for  the  subject  variable,  press 
[fio]  to  return  to  Step  1.  Errors  are  reported  at  the  bottom  of  the  screen 
and  are  corrected  by  pressing  (fT)  to  allow  respecification  of  the  data  for  the 
subject  variable. 


3.  Press  (fT)  to  process  the  cases  resulting  from  the  combinations  of  the  sets  of 
data  for  all  variables.  The  summary  of  each  case  will  be  sent  to  the  print 
file  or  device.  The  screen  will  display  the  total  number  of  cases  to  be 
processed  as  well  as  report  progress.  Errors  are  reported  at  the  bottom  of 
the  screen  and  are  corrected  by  pressing  (fT)  to  allow  respecification  of 
variable  sets. 

4.  Press  one  of  the  following  keys  to  select  the  appropriate  action: 


(fT)  Return  to  Step  1  to  specify  new  sets. 

[fio]  Exit  this  application  and  return  to  the  Wave  Prediction 
Application  Menu. 


Output 

Results  from  using  this  application  in  Multiple  Case  Mode  are  written  to  the 
Print  File  or  Device.  The  format  and  contents  reported  are  described  in  the 
Output  section  of  the  Single  Case  Mode  portion  of  this  document.  Refer  to  that 
section  for  details.  The  primary  difference  is  that  the  reported  data  are  not 
displayed  on  the  screen,  but  are  always  written  to  the  Print  File  or  Output  Device. 
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Example  Problems 

■  ’•  '  '  ''  s 


Example  1  -  Offshore  to  Onshore  Winds  -  Open-Water  Fetch  - 
Shallow- Water  Wave  Equations  > 


Input 


Main  Input  Screen 


Item 

:  '  "  •  /  ‘  \  .  '  '  /•  •  J  ’ 

Svmbol 

Ya,lye 

Unit$ 

Elevation  of  observed  wind 

^obs 

\(kjr  25 

ft 

Observed  wind  speed 

f^obs 

45 

mph 

Air-sea  temperature  difference 

•  ;  A/ 

Duration  of  observed  wind 

DUR 

3 

hr 

Duration  of  final  wind 

DUR 

'  3 

'■hr 

Latitude  of  wind  observation 

LAT 

30 

7  deg 

Wind  Observation  Type  ->  Shore  (windward) 
Wind  Fetch  Option  ->  Open  Water 


Open-Water  Wave  Growth  Equations  Requestor 


Open- Water  Wave  Growth  Equation 

->  Shallow 

Length  of  wind  fetch 

.  i 

F 

..  26 

mi 

Average  Depth  of  Fetch  Requestor 
Average  depth  of  fetch 

d 

13 

ft 

Output 

Item 

y 

Svmbol 

Value 

Units 

Equivalent  neutral  wind  speed 

ue 

;  ;  46.42 

mph 

Adjusted  wind  speed 

■  -  ;  Ua 

67.92 

mph 

.Wave  height 

■  ^mo 

'  ti  4.23 

ft  . 

Peak  wave  period 

T  V 

1  p  1 

4.77 

sec 

Wave  Growth:  Shallow- water  Fetch-limited 


—  i 

■y  :  }{  / 
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Example  2  -  Shipboard  Wind  Observation  -  Open-Water  Fetch  -  Deepwater 
Wave  Equations 

Input 


Main  Input  Screen 


Item 

Svmbol 

Value 

Units 

Elevation  of  observed  wind 

^obs 

60 

ft 

Observed  wind  speed 

^obs 

30 

knots 

Air-sea  temperature  difference 

AT 

-5 

deg  C 

Duration  of  observed  wind 

DUR 

1 

hr 

Duration  of  final  wind 

DUR 

3 

hr 

Latitude  of  wind  observation 

LAT 

45 

deg 

Wind  Observation  Type  ->  Overwater  (ship) 

Wind  Fetch  Option  ->  Open  Water 

Open-Water  Wave  Growth  Equations  Requestor 
Open-Water  Wave  Growth  Equation  ->  Deep 

Length  of  wind  fetch 

F 

60 

mi 

Output 

Item 

Svmbol 

Value 

Units 

Equivalent  neutral  wind  speed 

ue 

27.71 

knots 

Adjusted  wind  speed 

u* 

36.18 

knots 

Wave  height 

4.74 

ft 

Peak  wave  period 

TP 

4.65 

sec 

Wave  Growth:  Deepwater  Duration- 

-limited 
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Example  3  -  Overwater  Wind  Observation  -  Deepwater  Ware  Equations  - 
Restricted  Fetch  ■'  / 

Input  r 


Main  Input  Screen  r 


[  .  Item  •  V-;;’  ■  ■  • 

Symbol 

Value 

Units 

;  Elevation  of  observed  wind 

•'  30 

ft 

Observed  wind  speed 

45 

mph 

Air-sea  temperature  difference  * 

:  AT 

-3. 

deg  C 

Duration  of  observed  wind 

buR 

hr  ; 

:  Duration  of  final  wind 

:•  DUR 

• ' 

hr 

Latitude  of  wind  observation 

LAT 

-47' vj 

deg 

Wind  Observation  Type ->  Overwater 
|  Wind  Fetch  Option  ->  Restricted 


Restricted  Fetch  Requestor 

Wind  Direction  .  a  ,  Vv  125  deg 

NOTE:  a  is  measured  clockwise  from  north. 

>  Open-Water  Waye  Growth  Equation  ->  Deep 

Fetch  Geometry  Input  Options  ->  Keyboard 


Keyboard  Data  Entry  Requestor 

See  Figure  1-1-11  for  illustration  showing  wind  direction  and  fetch  geometry 
for  example  problem  3. 

Radial  Angle  Increment  A  p  12  ,  deg 

Dir  of  Radial  Fetch  -  pi  0  deg 

NOTE:  This  direction  angle  is  measured  clockwise  from 
north./’ 


No  of  Radial  Fetches  Nfet..  14 
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Fetch  Geometry  Data  Entry  Screen 


Units 


miles  Radial 
Number 
1 
2 

3 

4 

5 

6 

7 

8 

9 

10 
11 
12 

13 

14 


Fetch 

Fetch 

Angle 

Length 

0.0 

3.7 

12.0 

12.3 

24.0 

13.4 

36.0 

12.2 

48.0 

13.2 

60.0 

36.0 

72.0 

35.6 

84.0 

28.7 

96.0 

26.8 

108.0 

13.0 

120.0 

10.4 

132.0 

10. 1 

144.0 

6.4 

156.0 

5.7 

Figure  1-1-11.  Restricted  Fetch  Geometry  Illustration  for  Example  3 
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Output 


Item  ,  ;t  Symbol  Value  Units 

Wind  Fetch  F  26.61  mi 

Wind  Direction  125.00  deg 

Equivalent  neutral  wind  speed  Ue  44.00  mph 

Adjusted  wind  speed  f/a  63.27  mph 

Mean  Wave  Direction  93.00  deg 

Wave  height  //mp  7.80  .  ft 

Peak  wave  period  Tp  5.74  sec 

Wave  Growth:  Deepwater  Fetch-limited 
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Description 

This  application  provides  a  statistical  representation  for  a  shallow- water  wave 
height  distribution.  The  Beta-Rayleigh  distribution  is  expressed  in  familiar  wave 
parameters:  H  nv  (energy-based  wave  height),  fp  (peak  spectral  wave  period), 
and  d  (water  depth).  After  constructing  the  distribution,  other  statistically  based 
wave  height  estimates  such  as  H rms  ,  Hmean ,  H  tn 0  can  be  easily  computed.  The 
Beta-Rayleigh  distribution  features  a  finite  upper  bound  corresponding  to  the 
breaking  wave  height,  and  the  expression  collapses  to  the  Rayleigh  distribution 
in  the  deepwater  limit.  The  methodology  for  this  portion  of  the  application  is 

taken  exclusively  from  Hughes  and  Borgman  (1986). 

Input 

All  data  input  for  this  application  is  done  on  one  screen.  The  following  list 
describes; the  necessary  input  parameters  with  their  corresponding  units  and  range 
of  data  recognized  by  this  application:  ; :  :  . 


Output 


Item 

Symbol 

Units 

Data  Range 

Wave  height 

U 

11  mo 

ft,  m 

0.1 

to  60.0 

Wave  period 

T 

1  p 

sec 

:  .  2.0 

to  30.0 

Water  depth 

d  ' 

ft,  m 

0.1 

/  •;  .  .  .  •  ,  . 

to  3000.0 

Results  from  this  application  are  displayed  on  one  screen.  In  addition,  there  is 
an  option  (available  in  the  Single  Case  Mode  only)  to  send  data  to  plot  output 
file  1  (default  name  PLOTDAT1  .OUT).  This  application  also  generates  one 
screen  plot.  Each  of  these  outputs  is  described  below. 


Screen  Output 


Results  from  this  application  are  displayed  on  one  screen.  Those  data  include 
the  original  input  values  (in  final  units)  and  the  following  parameters: 


Item 

Symbol 

.  English 

Metric 

Units 

Units 

Root-mean-squared  (rms)  wave 

.  v  rms 

ft 

m 

height  . 

Median  wave  height 

H  mert 

.  ft 

m 

Beta-Rayleigh  Distribution 


1-2-1 


ACES  User's  Guide 


Wave  Prediction 


H  1/3 

ft 

m 

H  1/10 

ft 

m 

H  i/ioo 

ft 

m 

NOTE:  The  Beta-Rayleigh  distribution  will  revert  to  the  Rayleigh 
distribution  when  d/gT2  >  0.01 .  A  message  will  appear  at  the 
bottom  of  the  screen  when  this  occurs. 


Plot  Output  File  1 

Plot  output  file  1  contains  the  Beta-Rayleigh  or  Rayleigh  probability  density 
function  (pdf)  and  is  written  in  the  following  format  (see  Table  1-2-1  in  the 


example  problem): 

Field 

Columns 

Format 

Data 

1 

8-10 

13 

Point  counter 

2 

14-23 

F10.3 

Wave  height 

3 

33-42 

F10.3 

Beta-Rayleigh  or  Rayleigh  probability 

density 


Screen  Plot 

This  application  generates  one  plot  which  contains  seven  curves.  The  first  curve 
(solid  line)  is  the  Beta-Rayleigh  or  Rayleigh  prediction.  The  remaining  curves 
(represented  by  individual  symbols)  are  various  wave-height  probabilities  (see 
Figure  1-2-1  in  the  example  problem). 


Procedure 

The  bulleted  items  in  the  following  lists  indicate  potentially  optional  instruction 
steps.  Any  application  in  ACES  may  be  executed  in  a  given  session  without 
quitting  the  program.  The  bulleted  items  provide  instructions ’for  accessing  the 
application  from  various  menu  areas  of  the  ACES  program.  Ignore  bulleted 
instruction  steps  that  are  not  applicable. 

Single  Case  Mode 

°  Press  (fT)  on  the  Main  Menu  to  select  Single  Case  Mode. 

°  Fill  in  the  highlighted  input  fields  on  the  General  Specifications  screen 
(or  leave  the  default  values).  Press  (fT)  when  all  data  on  this  screen 
are  correct. 
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Press  [fT]  on  the  Functional  Area  Menu  to  select  Wave  Prediction. 

0  Press  (F2]  on  the  Wave  Prediction  Menu  to  select  Beta-Rayleigh 
'  Distribution.  .  ,  ;  A,,.- ..  1- 

1.  Fill  in  the  highlighted  input  fields  on  the  Beta-Rayleigh  Distribution  screen. 
,  Respond  to  any  corrective  instructions  appearing  at  the  bottom  of  the  screen. 

Press  (fT)  when  all  data  on  this  screen  are  correct. 

2.  All  input  and  output  data  are  displayed  on  the  screen  in  the  final  system  of 
units.  A 

3.  Press  one  of  the  following  keys  to  select  the  appropriate  action: 

(fT)  Return  to  Step  1  for  a  new  case. 

(F2)  ’  .  Plot  the  data.’. 

(F3]  Send  a  summary  of  this  case  to  the  print  file  or  device. 

(F4)  Generate  a  file  containing  the  plot  data  (Plot  Output  File  1). 
[fio]  Exit  this  application  and  return  to  the  Wave  Prediction  Menu. 


Multiple  Case  Mode 

°  Press  (F2)  on  the  Main  Menu  to  select  Multi  Case  Mode. 

Fill  in  the  highlighted  input  fields  on  the  General  Specifications  screen 
(or  leave  the  default  values).  Press  (fT)  when  all  data  on  this  screen 
are  correct. 

0  Press  (fT)  on  the  Functional  Area  Menu  to  select  Wave  Prediction. 

°  Press  [F2|  on  the  Wave  Prediction  Menu  to  select  Beta-Rayleigh 
Distribution. 

1.  Move  the  cursor  to  select  a  variable  on  the  Beta-Rayleigh  Distribution  screen 

(the  selected  variable  name  blinks).  The  current  set  of  values  for  the  variable 
is  displayed  on  the  right  portion  of  the  screen.  When  all  variable  sets  are 
correct,  go  to  Step  3.  .  '  \  A 

2.  Enter  a  set  of  values  for  the  subject  variable  by  following  one  of  the  input 
methods: 

a.  Press  ®  to  select  random  method.  Enter  up  to  20  values  constituting 
a  set  for  this  variable  tone  in  each  field)  on  the  right  side  of  the  screen. 
The  set  of  20  values  originally  displayed  (first  execution)  in  these  fields 
contains  the  "delimiting"  value,  which  "delimits”  or  "ends"  the  set.  The 
"delimiting"  value  is  not  included  as  a  member  in  the  set  unless  it  is 
the  sole  member. 

..  ;  •••  "  :  - : 
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b.  Press  (T)  to  select  incremental  method.  Fill  in  the  fields  for  minimum, 
maximum,  and  increment  values  for  this  variable  on  the  right  side  of 
the  screen.  In  this  method,  the  members  of  the  set  include  all  values 
from  the  minimum  to  the  maximum  (both  inclusive)  at  the  specified 
increment. 

The  units  field  should  also  be  specified  for  the  variable  regardless  of  input 
method.  All  members  of  a  set  of  values  for  a  subject  variable  are  assigned 
the  specified  units.  When  all  data  are  correct  for  the  subject  variable,  press 
[fio]  to  return  to  Step  1 .  Errors  are  reported  at  the  bottom  of  the  screen 
and  are  corrected  by  pressing  (fT)  to  allow  respecification  of  the  data  for  the 
subject  variable. 

3.  Press  (fT)  to  process  the  cases  resulting  from  the  combinations  of  the  sets  of 
data  for  all  variables.  The  summary  of  each  case  will  be  sent  to  the  print 
file  or  device.  The  screen  will  display  the  total  number  of  cases  to  be 
processed  as  well  as  report  progress.  Errors  are  reported  at  the  bottom  of 
the  screen  and  are  corrected  by  pressing  (fT|  to  allow  respecification  of 
variable  sets. 

4.  Press  one  of  the  following  keys  to  select  the  appropriate  action: 

(fI)  Return  to  Step  1  to  specify  new  sets. 

fFioj  Exit  this  application  and  return  to  the  Wave  Prediction  Menu. 

NOTE:  Multiple  Case  Mode  does  not  generate  any  plot  output 
files  or  plots. 

Example  Problem 


Input 


All  data  input  for  this  application  is  done  on  one  screen.  The  values  and 
corresponding  units  selected  for  this  example  problem  are  shown  below. 


Item 

Wave  height 
Wave  period 
Water  depth 


Svmbol 

Value 

Units 

Hmo 

5.00 

ft 

TP 

6.30 

sec 

cl 

10.20 

ft 
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Results  from  this  application  are  displayed  on  one  screen  and,  if  requested, 
written  to.  plot  output  file  1  (default  name  PLOTDATl.OUT).  In  addition,  one 
plot  is  generated.  Each  of  these  outputs  for  the  example  problem  is  presented 
’•  below.'  \  : 

Screen  Output 

Results  from  this  application  are  displayed  on  one  screen.  Those  data  include 
the  original  input  values  and  the  following  parameters: 


Item 

Symbol  ■ 

Value 

Unit? 

Wave  heights 

u 

rfn» 

3.72 

ft 

H  tned 

3.26 

-  ft. 

•  V.  •  *  ••  •'  ’  V  -'  .  •  ' ' 

H  1/3 

5.18 

ft 

H  i/io 

6.55 

;  ft ; 

H  l  / 1  oo 

7.48 

ft 

.  Plot  Output  File  1 

Table  1-2-1  below  is  a  partial  listing  of- plot  output  file  1  (default  name 
PLOTDATl.dUT):  generated  by  this  application  for  the.  example  problem. 

v  ■  ::  Table  1-2-1  y,\  ' 

Partial  Listing  of  Plot  Output  File  1  for  Example 
Problem 


Counter 

Wave  height 

.Probability 
\  density 

1 

0.00000 

0.00000 

2 

0.10200 

0.03707 

3 

0.20400 

0.07630 

%  4 

0.30600 

0.11618 

5 

0.40800 

V  0.15624 

6 

0.51000 

0.19621 

.  .7  . 

0.61200 

0.23586 

8  "■ 

0.71400 

1  0.27499 

9 

0.81600 

0.31342 

TO 

0.91800 

0.35100 

11 

1.02000 

0.38756 

12 

1.12200 

0.42297 

13 

...•.r  1.22400 

0.45710 

l 

11 

11 

(Table  1 
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(Table  1-2-1  Concluded) 


89 

8.97600 

0.00085 

90 

9.07800 

0.00054 

91 

9.18000 

0.00033 

92 

9.28200 

0.00019 

93 

9.38400 

0.00010 

94 

9.48600 

0.00005 

95 

9.58800 

0.00002 

96 

9.69000 

0.00001 

97 

9.79200 

0.00000 

98 

9.89400 

0.00000 

99 

9.99600 

0.00000 

100 

10.09800 

0.00000 

101 

10.20000 

0.00000 

Screen  Plot 

This  application  generates  one  plot.  The  plot  may  be  accessed  by  selecting  the 
Plot  Data  option  ((F2|)  from  the  Options  menu  on  the  data  output  screen.  The 
plot  generated  is  shown  in  Figure  1-2-1  below.  The  first  curve  (solid  line)  is 
the  Beta-Rayleigh  or  Rayleigh  prediction.  The  remaining  curves  (represented 
by  single  symbols)  are  various  wave-height  probabilities.  (This  figure  has  been 
slightly  altered  from  its  actual  appearance  on  screen  to  allow  the  wave  height 
probability  symbols  to  be  clearly  visible.) 


& 

B 

& 
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Figure  1-2-1.  Beta-Rayleigh  Predictions  for  Example  Problem 
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Description 


Input 


This  application  provides  significant  wave  height  estimates  for  various  return 
periods.  Confidence  intervals  are  also  provided.  The  approach  developed  by 
Goda  (1988)  is  used  to  fit  five  candidate  probability  distributions  to  an  input 
array  of  extreme  significant  wave  heights.  Candidate  distribution  functions  are 
Fisher-Tippett  Type  I  and  Weibull  with  exponents  ranging  from  0.75  to  2.0. 
Goodness -of -fit  information  is  provided  f or  identifying  the  distributions  which 
best  match  the  input  data.  ,  •  -1 


The  input  requirements  of  this  application  consist  of  the  following  information: 
°  Estimated  total  number  of  events  (Nj)  from  the  population  during  the 
length  of  record.  .  .. 

'  Length  of  the  record  in  years  (K). 

°  Water  depth  to  check  for  depth-limited  wave  heights. 

0  Significant  wave  heights  (H„)  from  long-term  data  source  of 
measurements,  hindcasts,  or  observations. 

0  Confidence  level  for  calculating  a  confidence  interval. 

Data  input  to  this  application  is  accomplished  through  numerous  input  screens 
or  through  data  saved  in  an  external  file.  Detailed  lists  of  the  screens  and  input 
parameters  are  presented  in  the  Procedure  section  of  this  document. 


Output 


'S’  <■': 


Results  from  this  application  are  displayed  on  three  screens  and  written  to  plot 
output  file  1  (default  name  PI.OTDAT1  OUT).  This  application  also  generates 
five  plots.  The  three  output  screens  and  five  plots  are  described  in  the  Procedure 
section  of  this  document.  The  content  of  the  plot  output  file  is  described  below 
(refer  to  the  Example  Problem  section  for  a  paradigm).  Equation  numbers  given 
below  and  referenced  in  the  plot  output  file  refer  to  equations  in  Section  1-3 
of  the  ACES  Technical  Reference,  titled  Extremal  Significant  Wave  Height 
Analysis.  '  '"-v 
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This  file  contains,  for  each  of  the  five  distributions,  tabular  summaries  of: 

0  Correlation  and  the  sum  of  the  squares  of  the  residuals. 

°  Estimates  of  the  scale  and  location  parameters  from  linear  regression 
analysis. 

0  The  probability  assigned  to  each  significant  wave  height  (Equation  3). 
°  A  reduced  variate  (Equation  5). 

°  An  ordered  variate  (Equation  4). 

°  Difference  between  the  significant  wave  height  and  the  ordered  variate. 
°  Expected  extreme  wave  height  for  a  given  return  period  (Equation  6). 
°  Absolute  magnitude  of  the  standard  deviation  of  significant  wave  height 
(Equation  10). 

Procedure 


This  application  provides  only  a  Single  Case  Mode.  The  Multiple  Case  Mode  is 
not  available.  The  Single  Case  Mode  requires  interaction  with  the  application 
and  provides  two  options  of  interactive  participation.  The  first  option  allows 
entering  new  data  sets,  and  the  second  option  allows  the  editing  of  existing  data 
files. 

Single  Case  Mode 

0  Press  (fT)  on  the  Main  Menu  to  select  Single  Case  Mode. 

°  Fill  in  the  highlighted  input  fields  on  the  General  Specifications  screen 
(or  leave  the  default  values).  Press  (fT)  when  all  data  on  this  screen 
are  correct. 

°  Press  (fT)  on  the  Functional  Area  Menu  to  select  Wave  Prediction. 

°  Press  (F3]  on  the  Wave  Prediction  Menu  to  select  Extremal  Significant 
Wave  Height  Analysis. 


Data  Entry  Options  Menu 

This  menu  provides  two  options  of  interactive  participation  with  the  application. 
[FI)  Initial  Case  Data  Entry 

Use  this  option  to  enter  an  initial  (new)  set  of  data.  These  data  will 
be  written  to  the  Trace  Output  file  (default  name  TRACE. OUT)  and 
become  available  for  subsequent  editing  and  use. 
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[aTF|  (fT)  Edit  Case  in  External  File:  EXTREMAL. IN 

Use  this  option  to  access  and  modify  data  saved  in  an  external  file. 
This  external  data  file  is  created  by  saving  (or .copying)  a  trace  file 
from  a  previous  execution  of  this  application.  The.  format  and  contents 


this  input  file.  The  default  input  filename  is  EXTREMAL. IN,  but 
other  filenames  (including  pathname)  are  acceptable.  After  entering 
the  filename,  press  t  av  ter  )  to  accept  this  file.  For  more  information 
-  on  files,  see  the  section  of  this  manual  entitled,  "General  Instructions 
’  1  and  Informdtion.":  '(  '■)  '  • 


Activity  Menu  I  .  '■[ 

The.  Activity  Menu  is  a  point  from  which  all  options  for  Single  Case  data  entry 
i:  ;  -modification,  and  execution,  are  accessible.  The  options  are: 

(fT|  Begin  Computations.  " 

■  •  .u-  ■  -  [F2)  Significant  Wave  Height  Entry:, 

|F3)  :  Confidence  Interval  Timits  Entry.  V 

(F4]  Review  Output  Screens. .  ,  j  . 

(fs)  Plot  Output  Data. 

(fioJ  .Exit  Menu.  i  1 

Each  option  and  the  required  data  are  described  below. 


~s  • 


(fT|  Begin  Computations 


! 

I 


(£2)  Significant  Wave  Height  Data  Entry 


This  screen  provides  for  input  of  general  parameters  required  to  run  the 
application.  Values  for  all  parameters  listed  are  required. 


"X 


# 
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Item 

Units 

Data  Ranee 

Units 

ft,m 

Nx 

0 

to  10000.0 

Period  (yr)  K 

years 

0 

to 

999.9 

Water  Depth 

ft,m 

0 

to 

1000.0 

Significant  Wave  Height  for  Each  Storm 

ft,m 

0 

to 

100.0 

NOTE:  There  is  space  provided  on  this  screen  to  enter  a  title  or 
description  (optional)  to  identify  where  the  significant  wave  data 
is  coming  from.  This  title  will  appear  in  the  plot  output  file  for 
reference. 

NOTE:  If  there  are  more  than  50  significant  heights  to  be  entered, 
press  (fT)  to  access  subsequent  screens  for  entering  the  remaining 
values.  Each  screen  will  allow  input  of  50  values.  The  application 
will  allow  for  a  maximum  of  200  values  to  be  entered.  After 
completing  data  entry  on  this  screen,  press  [fio)  to  return  to  the 
Activity  Menu. 


(F3]  Confidence  Interval  Limits  Entry 

This  screen  provides  for  selecting  a  particular  Confidence  Interval.  Use  the 
arrow  keys  to  move  the  blinking  cursor  to  the  desired  Confidence  Interval  and 
press  @  to  select  it.  The  choices  are: 

80%  Confidence  Interval 
85%  Confidence  Interval 
90%  Confidence  Interval 
95%  Confidence  Interval 
99%  Confidence  Interval 


(F4)  Review  Output  Screens 

This  option  allows  for  viewing  the  output  of  this  application,  which  appears  on 
three  screens.  The  three  screens  are  described  below: 
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The  first  screen  is  a  table  of  extremal,  significant  wave  heights  for 
different  return  periods  for  the  five  distribution  functions.  Also 
included  in  the  table  are  two  statistics  (correlation  and  sum  of  the 
squares  of  the  residuals)  to  assist  in  selecting  the  best  fit  distribution 
f unction. 

The  second  screen  is  a  table  of  confidence  intervals  for  different  return 


The  third  screen  is  a  table  of  percent  chance  that  the  significant 


the  period  of  concern. 


(fs)  Plot  Output  Data  (  - 

This  application  generates  five  plots.  The  plots  may  be  accessed  from  the 
EXTREMAL  WAVE  HEIGHT  PLOT  MENU,  which  appears  when  the  Plot  Output 
Data  option  is  requested.  To  access  a  plot,  move  the  cursor  (using  the  arrow 
keys)  to  the  desired  plot  and  press  [Ft):  (Appendix  C  describes  options  to 
customize  plots.)  Available  plots  are:  ' 

0  Fisher-Tippett  (FT-I)  (see  Figure  1-3-1) 

.  0  Weibull  Dist  (k=0.75)  (see  Figure  1-3-2) 

-  •  Weibull  Dist  (k=1.00)  (see  Figure  1-3-3)  . 

;  •  Weibull  Dist  (k=1.40)  (see.  Figure  1-3-4) 

0  Weibull  Dist  (k=2.00)  (see  Figure  1-3-5) 

’  ALL  PLOTS  XV* 

NOTE:  This  option  will  make  all  the  plots  available  for 
.  viewing.  Use  the  NEXT  option  of  the  graphics  package 

,:.  v  (Appendix  C)  to  view  each  plot  successively. 

EXIT  MENU  ' 


Each  plot  contains  four  curves: 

... 0  Expected  extreme  wave  heights  for.  given  return  periods. 
°  Candidate  probability  distribution. 
v 9 .  Upper  confidence  limit.' 

°  Lower  confidence  limit.  r-;: v  ' 
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Example  Problem 

Input 

The  input  for  this  example  problem  has  been  saved  in  an  example  file  called 
EXTDELFT.IN.  Refer  to  the  section  titled  Procedure  for  instructions  to  invoke 
and  run  this  data  set. 


(F2]  Significant  Wave  Height  Data  Entry 

Item  Value 

Units  meters 

Nt  20 

Period  (yr)  K  20 

Water  Depth  500 

Significant  Wave  Height  for  Each 
Storm 

1  9.32 

2  8.11 

3  7.19 

4  7.06 

5  6.37 

6  6.15 

7  6.03 

8  5.72 

9  4.92 

10  4.90 

11  4.78 

12  4.67 

13  .  4.64 

14  4.19 

15  3.06 


(F3)  Confidence  Interval  Limits  Entry 
90%  Confidence  Interval 
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Output 


Results  from  this  application  are  displayed  on  three  screens  and  written  to  plot 
output  file  1  (default  name  PLOTDATl.OUT).  .  In  addition  five  plots  are 
generated.  Each  of  these  outputs  is  described  below. 


Screen  Output 


The  first  screen  is  a  table  of  extremal  significant  wave  heights  for  different 
.return  periods  for  the  five  distribution  functions.  Also  included  in  the  table  are 
two  statistics  (correlation  and  sum  of  the  squares  of  the  residuals)  to  assist  in 
selecting  the  best  fit  distribution  function. 


First  Screen 


Weibull  Distribution 


LAMBDA  =  1 .00 


Correlation 

Sum  Square  of  Residuals 


Return  Period  (Yr) 
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The  second  screen  is  a  tabic  of  confidence  intervals  for  different  return  periods 
for  the  five  distribution  functions. 


Second  Screen 

90%  Confidence  Interval  (Lower  Bound  -  Upper  Bound)  UNITS  (ft) 

Return 

FT-I 

Weibull  Distribution 

Period 

k=0.75 

k=1.00 

k=I  .40 

k=2.00 

5 

17.7  -  25.3 

15.1  -  25.3 

16.4  -  25.4 

17.2  -  25.9 

17.8  -  26.2 

10 

19.7  -  30.7 

15.8  -  32.2 

17.9  -  31.7 

19.2  -  31.3 

20.1  -  31.0 

25 

22.0  -  37.7 

16.5  -  42.8 

19.7  -  40.1 

21.6  -  38.0 

22.5  -  36.4 

50 

23.6  -  43.0 

17.1  -  51.5 

21.1  -  46.5 

23.2  -  42.6 

24.1  -  40.0 

100 

25.2  -  48.2 

17.8  -  60.8 

22.4  -  52.9 

24.7  -  47.1 

25.5  -  43.3 

The  third  screen  is  a  table  of  percent  chance  that  the  significant  wave  height 
will  equal  or  exceed  the  return-period  significant  height  during  the  period  of 
concern. 


Third  Screen 

Percent  Chance  for  Significant  Height  Equaling  or 

Period  Hg 

Exceeding  Return 

Return 

Period  of  Concern  (Yr) 

Period 

2 

5 

10 

25 

50 

100 

2 

75 

97 

100 

100 

100 

100 

5 

36 

67 

89 

100 

100 

100 

10 

19 

41 

65 

93 

99 

100 

25 

8 

18 

34 

64 

87 

98 

50 

4 

10 

18 

40 

64 

87 

100 

2 

5 

10 

22 

39 

63 
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Plot  Output  File  1 

This  file  contains,  for  each  of  the  five  distributions,  tabular  summaries  of: 
Correlation  and  the  sum  of  the  squares  of  the  residuals. 

°  Estimates  of  the  scale  and  location  parameters  from  linear  regression 
-j.  •  analysis.  ■  vi  "■  :;v  1%'; 

■  °  The  probability  assigned  to  each  significant  wave  height  (Equation  J). 

°  A  reduced  variate  (Equation  5). 
r1-:'  •  ”  An  ordered  variate  (Equation  4).  ■ 

°  Difference  between  the  significant  wave  height  and  the  ordered  variate. 

°  Expected  extreme  wave  height  for  a  given  return  period  (Equation  6). 

4  Absolute  magnitude  of  the  standard  deviation  of  significant  wave  height 
(Equation  70).  . 

j  Equation  numbers  refer  to  equations  in  Section  1-3  of  the  ACES  Technical 

Reference,  titled  Extremal  Significant  Wave  Height  Analysis. 

Table  i-3-1  is  a  complete  listing  of  plot  output  file  1  (default  name 
PLOTDAT1  .OUT). 


•  !• 

1.  • 

i 

'  j.  y  '  ' 

5 

1 


i 


Table  1-3-1 

Listing  of  Plot  Output  File  1  for  Example  Problem 

EXTREMAL  SIGNIFICANT  WAVE  HEIGHT  ANALYSIS 

DELFT  Data  ?'  •>' 


N  =  15  STORMS 

NT  =  20  STORMS  ' 

NU  =  0.75.  /'• 

K  =  20.00  YEARS  %. 

LAMBDA  =  1.00  STORMS  PER  YEAR 
MEAN  OF  SAMPLE  DATA  =  19.053  FEET 
STANDARD  DEVIATION  OF  SAMPLE  -  5.341  FEET 


(Table  1-3^1  Continued  on  the  Next  Page) 
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(Table  1-3-1  Continued) 

FISHER-TIPPETT  TYPE  I  (FT-I)  DISTRIBUTION 
F(Hs)  =  EXP(-EXP(-(Hs-B)/A))  -  Equation  1 
A  =  4.910  FEET 
B  =  14.136  FEET 
CORRELATION  =  0.9813 

SUM  SQUARE  OF  RESIDUALS  =  0.1601  FEET 


RANK 

Hsm 

F(Hs<=Hsm) 

Ym 

A*Ym+B 

Hsm-(A*Ym+B) 

(Ft) 

Eq.  3 

Eq.  5 

(Ft) 

(Ft) 

Eq.  4 

1 

30.58 

0.9722 

3.567 

31.6513 

-1.0739 

2 

26.61 

0.9225 

2.517 

26.4935 

0.1141 

3 

23.59 

0.8728 

1.994 

23.9281 

-0.3388 

4 

23.16 

0.8231 

1.636 

22.1690 

0.9937 

5 

20.90 

0.7734 

1.359 

20.8064 

0.0926 

6 

20.18 

0.7237 

1.129 

19.6777 

0.4995 

7 

19.78 

0.6740 

0.930 

18.7014 

1.0821 

8 

18.77 

0.6243 

0.752 

17.8303 

0.9361 

9 

16.14 

0.5746 

0.590 

17.0340 

-0.8922 

10 

16.08 

0.5249 

0.439 

16.2914 

-0.2153 

11 

15.68 

0.4751 

0.296 

15.5868 

0.0956 

12 

15.32 

0.4254 

0.157 

14.9071 

0.4145 

13 

15.22 

0.3757 

0.021 

14.2407 

0.9824 

14 

13.75 

0.3260 

-0.114 

13.5761 

0.1706 

15 

10.04 

0.2763 

-0.252 

12.9003 

-2.8609 

RETURN  PERIOD  TABLE  with 

90%  CONFIDENCE  INTERVAL 

RETURN 

Hs  SIGR 

Hs- 

1.28*SIGR 

Hs+1.28*SIGR 

PERIOD 

(Ft)  (Ft) 

(Ft) 

(Ft) 

(Yr) 

Eq.  6  Eq.  10 

2.00 

15.94  1.38 

13.66 

18.21 

5.00 

21.50  2.27 

17.75 

25.25 

10.00 

25.18  3.32 

19.71 

30.66 

25.00 

29.84  4.76 

21.99 

37.69 

50.00 

33.29  5.86 

23.63 

42.96 

100.00 

36.72  6.96 

25.24 

48.20 

(Table  1-3-1  Continued  on  the  Next  Page) 
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(Table  1-3-1  Continued) 

.  :  ■  .  WEIBULL  DISTRIBUTION  k  =  0.75 

F(Hs)  -  1  -EXP(-((Hs-B)/A)**k)  Equation  2  ;  ...  ■  .; 

A  =  3.310  FEET 
B  =  13.933  FEET 
CORRELATION  =  0.9414 

SUM  SQUARE  OF  RESIDUALS  -  0.7816  FEET 


RANK 

Hsm 

F(Hs<=Hsm) 

Ym 

A*Ym+B 

.  Hsm-(A*Ym+B) 

(Ft) 

Eq.  3  T 

Eq.  5 

(Ft) 

Eq.  4 

(Ft) 

i  '-;;; 

30.58- 

0.9761 

5.796 

33.1177 

-2.5403 

2 

26.6i : 

0.9273 

3.614 

25.8942 

0.7134  i 

•  3  •  . 

23.59  t 

0.8784  < 

2.701 

22.8739 

0.7153 

V-  4 

23.  re 

0.8296 

2.140 

21.0156 

2.1471 

5 .’::■■■■ 

20.90 

0.7.807  / 

1.744 

19.7032 

1.1957 

6 

20.18 

0.7318 

1.442  : 

18.7065 

1.4707 

7  • 

19.78 

0.6830 

1.203  *; 

17.9146 

1.8688 

8 

18.77 

0.6341 

1.007 

17.2663 

1.5001 

9 

16.14 

0.5852 

0.843 

16.7240 

-0.5823 

10 

16.08  . 

0.5364 

0.704 

16.2632 

-0.1871 

11 

15.68  • 

0,4875,  C 

0.585 ' 

15.8672 

-0.1848 

12 

15.32 

0:4387 

0.481 

15.5241 

-0.2025 

13 

15.22 

0.3898 

0.390  : 

15.2250 

-0.0019 

14 

13.75 

0.3409 

0.311 

14.9635 

-1.21,68 

15 

10.04 

0.2921 

0.242  y. 

14.7347 

-4.6954 

RETURN  PERIOD  TABLE  with  90%  CONFIDENCE  INTERVAL 


RETURN 

Hs 

SIGR 

Hs-1.28*SIGR 

Hs+1 .28*SIGR 

PERIOD 

(Yr) 

(Ft) 

Eq.  6 

(Ft)  ’ 
Eq.  10 

'  (Ft) 

(Ft) 

2.00 

15.96 

1.47  , 

13.54 

18.38 

5.00 

20.18 

3.08 

15.09 

25.26 

10.00  , 

..  24.00 

4.99 

i-L  15.76: 

32.23 

25.00 

29.66 

7.95 

16.54 

42.78 

50.00 

34.33 

10.42 

17.14 

51.53 

100.00 

39.29 

13.05 

17.75 

60.83 

(Table  1-3-1  Continued  on  the  Next  Page) 
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(Table  1-3-1  Continued) 
WEIBULL  DISTRIBUTION  k  =  1.00 
F(Hs)  =  1  -EXP(~((Hs-B)/A)**k) 

A  =  5.592  FEET 

B  =  11.913  FEET 

CORRELATION  =  0.9674 

SUM  SQUARE  OF  RESIDUALS  =  0.3568  FEET 


RANK 

Hsm 

F(Hs<=Hsm) 

Ym 

A*Ym+B 

Hsm-(A*Ym+B) 

(Ft) 

Eq.  3 

Eq.  5 

(Ft) 

(Ft) 

Eq.  4 

1 

30.58 

0.9741 

3.652 

32.3332 

-1.7558 

2 

26.61 

0.9251 

2.592 

26.4053 

0.2023 

3 

23.59 

0.8762 

2.089 

23.5930 

-0.0038 

4 

23.16 

0.8272 

1.756 

21.7306 

1.4321 

5 

20.90 

0.7783 

1.506 

20.3359 

0.5630 

6 

20.18 

0.7293 

1.307 

19.2206 

0.9566 

7 

19.78 

0.6804 

1.141 

18.2912 

1.4923 

8 

18.77 

0.6314 

0.998 

17.4944 

1 .2720 

9 

16.14 

0.5825 

0.873 

16.7972 

-0.6555 

10 

16.08 

0.5335 

0.763 

16.1773 

-0.1012 

11 

15.68 

0.4846 

0.663 

15.6194 

0.0630 

12 

15.32 

0.4356 

0.572 

15.1121 

0.2094 

13 

15.22 

0.3867 

0.489 

14.6470 

0.5761 

14 

13.75 

0.3377 

0.412 

14.2177 

-0.4710 

15 

10.04 

0.2888 

0.341 

13.8190 

-3.7796 

RETURN  PERIOD 

TABLE  with 

90%  CONFIDENCE  INTERVAL 

RETURN 

Hs 

SIGR 

Hs- 

I.28*SIGR 

Hs+1.28*SIGR 

PERIOD 

(Ft) 

(Ft) 

(Ft) 

(Ft) 

(Yr) 

Eq.  6 

Eq.  10 

2.00 

15.79 

1.41 

13.46 

18.12 

5.00 

20.91 

2.75 

16.38 

25.45 

10.00 

24.79 

4.18 

17.89 

31.68 

25.00 

29.91 

6.17 

19.73 

40.10 

50.00 

33.79 

7.71 

21.07 

46.51 

100.00 

37.66 

9.25 

22.39 

52.93 

(Table  1-3-1  Continued  on  the  Next  Page) 
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(Table  1-3-1  Continued) 
WEIBULL  DISTRIBUTION  k  =  1.40 
F(Hs)  =  1  EXP(-((Hs-B)/A)**k) 

A  =  9.115  FEET 
'  B  .=  $.756  FEET  .  . 

;  CORRELATION  =  0.9818  -  ; 

SUM  SQUARE  OF  RESIDUALS  =  0.2201  FEET 


RANK 

Hsm 

F(Hs<=Hsm) 

Ym 

A*Ym+B 

Hsm-(A*Ym+B) 

vv  '•  ■' 

(Ft) 

Eq.  3  - 

Eq.  5 

;(Ft) 

(Ft) 

j  '  '•v'-.'y  .  > 

Eq.  4 

-VI 

30.58 

0.9720  , 

2.484 

31.3960 

-0.8185  : 

;  ■  .’fe-Hv'  :•  ' 

.  2  ■ 

26.61..  ?. 

0.9229  • 

1.959 

26.6092 

-0.0016 

•\  ..v-  3  V  •: 

23.59 

0.8739 

1.682 

24.0859 

-0.4967 

:>•: ''  \*s-_  ■'  " 

VV:  4  ...  ■ 

23.16  1 

0.8249 

1.487 

223067 

0.8561- 

'  :  .  V  v;/ 

5  /:  . 

20.90 

0.7758 

1.333 

20.9058 

-0.0068 

■■■;■  6  :  V 

20.18 

0.7268 

1.204 

19.7347 

0.4424 

!.,  •  •  :  ' 

,J 

19.78 

0.6778 

1.093 

18.7179 

1.0655 

■  8  ;  j  ' 

18.77 

0.6287 

0.993 

17.8111 

0.9553 

'  9 

16.14 

0.5797 

0.903 

16.9861 

-0.8444 

.  10  ; 

16;08  X 

0.5307 

0.8  L9 

16.2233 

-0.1472 

;  '  •  •  -v 

Avilov!-. 

15.68 

0.4816 

0.741- 

15.5087 

0.1737 

'  •’  :  -V. 

i2  a 

15.32 

r.  0.4326  ’ 

0.667 

14.8314 

0.4901 

i 

13  : 

15.22 

0.3836 

0.595 

14.1826 

1.0405 

»  :  . 

14  ;.  r  : 

13.75 

0.3345 

0.526 

13.5545 

0.1922 

•j-  ■••• '  •'*;  .-.j.' •  ; 

15 

10.04 

0.2855 

0.459  : 

12.9400 

-2.9007 

RETURN  PERIOD  TABLE  with  90%  CONFIDENCE  INTERVAL 


RETURN 

Vi.  Hs  V  • 

SIGR 

Hs-1.28*SIGR 

Hs+1.28*SIGR 

PERIOD 

(Ft) 

(Ft) 

(Ft)  V 

’(Ft) 

(Yr) 

Eq.  6 

Eq.  JO 

2.00 

15.77  ,i 

1.45 

13.37  V 

18  17 

5.00  fl 

21.56 

2.63 

17.22  ' 

25.91 

10.00 

25.29 

3.66- : 

19.25 

31.34 

25.00 

29.76 

4.97 

21.56  V  V 

37.96 

50.00  x 

32.90  V 

5.91 

23.16  • 

42.65 

100.00 

35.89 

6.80 

24.66 

47.12 

(Table  1-3- 
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(Table  1-3-1  Concluded) 
WEIBULL  DISTRIBUTION  k  =  2.00 
F(Hs)  =  1  -EXP(-((Hs-B)/A)**k) 

A  =14.115  FEET 

B  =  4.112  FEET 

CORRELATION  =  0.9866 

SUM  SQUARE  OF  RESIDUALS  =  0.1034  FEET 


RANK 

Hsm 

F(Hs<=Hsm) 

Ym 

A*Ym+B 

Hsm-(A*Ym+B) 

(Ft) 

Eq.  3 

Eq.  5 

(Ft) 

(Ft) 

Eq.  4 

1 

30.58 

0.9701 

1.873 

30.5547 

0.0228 

2 

26.61 

0.9210 

1.593 

26.5991 

0.0085 

3 

23.59 

0.8719 

1.433 

24.3450 

-0.7557 

4 

23.16 

0.8228 

1.315 

22.6789 

0.4838 

5 

20.90 

0.7737 

1.219 

21.3167 

-0.4178 

6 

20.18 

0.7245 

1.135 

20.1395 

0.0376 

7 

19.78 

0.6754 

1.061 

19.0852 

0.6983 

8 

18.77 

0.6263 

0.992 

18.1165 

0.6500 

9 

16.14 

0.5772 

0.928 

17.2087 

-1.0670 

10 

16.08 

0.5281 

0.867 

16.3443 

-0.2682 

11 

15.68 

0.4790 

0.807 

15.5096 

0.1728 

12 

15.32 

0.4299 

0.750 

14.6931 

0.6285 

13 

15.22 

0.3808 

0.692 

13.8842 

1.3389 

14 

13.75 

0.3317 

0.635 

13.0725 

0.6742 

15 

10.04 

0.2826 

0.576 

12.2461 

-2.2067 

RETURN  PERIOD  TABLE  with 

90%  CONFIDENCE  INTERVAL 

RETURN 

Hs  SIGR 

Hs- 

I.28*SIGR 

Hs+1.28*SIGR 

PERIOD 

(Ft)  (Ft) 

(Ft) 

(Ft) 

(Yr) 

Eq.  6  Eq.  10 

2.00 

15.86  1.51 

13.37 

18.36 

5.00 

22.02  2.55 

17.81 

26.23 

10.00 

25.53  3.32 

20.06 

31.00 

25.00 

29.44  4.22 

22.48 

36.39 

50.00 

32.03  4.83 

24.06 

40.00 

100.00 

34.40  5.40 

25.50 

43.30 
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Screen  Plots 

This  application  generates  five  plots.  The  plots  may  be  accessed  from  the 
EXTREMAL  WAVE  HEIGHT  PLOT  MENU,  which  appears  when  the  Plot  Output 
Data  option  ([FSft  from  the  Activity  Menu  is  requested.  To  access  a  plot,  move 
the  cursor  (using  the  arrow  keys)  to  the  desired  plot  and  press  .(fT).  (Appendix 
C  describes  options  to  customize  plots.)  The  plots  generated  are  shown  in  Figures 
:  1-3-1  through  1-3-5. 
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Figure  1-3-1.  Fisher-Tippett  Distribution  and  Expected  Extreme  Wave  Heights 

with  Confidence  Limits  \ 
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Figure  1-3-2.  Weibull  Distribution  (k=0.75)  and  Expected  Extreme  Wave  Heights 

with  Confidence  Limits 
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Figure  1-3-3.  Weibull  Distribution  (k=1.0D)  and  Expected  Extreme  Wave  Heights 

with  Confidence  Limits 


Figure  1-3-4.  Weibull  Distribution  (k=1.40)  and  Expected  Extreme  Wave  Heights 

with  Confidence  Limits 
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Figure  1-3-5.  W-eibull  Distribution  (k=2.00)  and  Expected  Extreme  Wave  Heights 

with  Confidence  Limits 
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Constituent  Tide  Record  Generation 


Description 

This  ACES  application  predicts  a  tide  elevation  record  at  a  specific  time  and 
locale  using  known  amplitudes  and  epochs  for  individual  harmonic  constituents. 


Input  \  ^ 

The  input  requirements  of  this  application  consist  of  two  general  types  of 
information. 

>  ;  9  General  temporal  data. 

°  Constituent  data  for  the  particular  desired  location. 

Data  input  to  this  application  is  accomplished  by  interaction  with  several  input 
screens  or  by  reading  data  from  an  external' file:  Detailed  lists  of  the  screens 
and  input  parameters  are  presented  in  the  Procedure  section  of  this  document. 


Output 

-  This  application  generates  one  plot  (see  section  titled  Plot  Output  Data).  In 
addition,  there  is  an  option  to  send  data  to  plot  output  file  1  (default  name 
PLOTDAT1  .OUT).  The  contents  and  organization  of  output  data  in  the  plot 
output  file  are  summarized  below. 

Plot  Output  File  1  :'ii:  ■'  *; 

This  file  contains  the  tide  elevation  at  specific  times.  Plot  output  file  1  is  written 
in  the  following  format: 

Field  Columns  Format  Data 

1  .  1-8  F8.2  Time  in  hours  from  beginning  of 

simulation 

2  19-26  F8.2  Elevation  of  the  tide 
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Procedure 

This  application  provides  only  a  Single  Case  Mode.  The  Multiple  Case  Mode  is 
not  available.  Single  Case  Mode  requires  interaction  with  the  application  and 
provides  two  options  of  interactive  participation.  The  first  option  allows  entering 
new  data  sets,  and  the  second  option  allows  editing  of  data  sets  read  from  an 
external  file. 


Single  Case  Mode 

The  bulleted  items  in  the  following  lists  indicate  potentially  optional  instruction 
steps.  Any  application  in  ACES  may  be  executed  in  a  given  session  without 
quitting  the  program.  The  bulleted  items  provide  instructions  for  accessing  the 
application  from  various  menu  areas  of  the  ACES  program.  Ignore  bulleted 
instruction  steps  that  are  not  applicable. 


Press  (fT)  on  the  Main  Menu  to  select  Single  Case  Mode. 

Fill  in  the  highlighted  input  fields  on  the  General 
Specifications  screen  (or  leave  the  default  values).  For 
information  on  input  requirements  on  the  General 
Specifications  screen,  please  refer  to  the  section  of  the  User’s 
Guide  entitled  "General  Instructions  and  Information."  Press 
(Fp  when  all  data  on  this  screen  are  correct. 

Press  |fT)  on  the  Functional  Area  Menu  to  select  Wave 
Prediction. 

Press  (F4)  on  the  Wave  Prediction  Menu  to  select  Constituent 
Tide  Record  Generation. 


Data  Entry  Options  Menu 

This  menu  provides  two  options  of  interactive  participation  with  the 
application: 


Initial  Case  Data  Entry 

Use  (fT)  option  to  enter  an  initial  (new)  set  of  data.  These  data  will  be 
written  to  the  Trace  Output  file  and  become  available  for  subsequent  editing 
and  use. 


1-4-2 


Constituent  Tide  Record  Generation 


Wave  Prediction 


ACES  User’s  Guide 


•Edit  Case  in  an  External  File  ,  -■  ci'-.- =l- * v ' 

Use  [Ait]  [fi]  option  to  access  and  modify  data  from  an  external  file.  This 
external  data  file  is  created  by  saving  (or  copying)  a  trace  file  from  a 
previous  execution  of  this  application.  The  format  and  contents  of  the 


file.  The  default  input  file  name  is  TIDES.IN,  but  other  filenames 
(including  pathname)  are  acceptable.  After  entering  the  filename,  press 
(  enter)  to  accept  this  file.  For  more  information  on  files,  see  the  section 
of  this  manual  entitled  "General  Instructions  and  Information." 


Activity  Menu 


The  Activity  Menu  is  a  pivotal  point  from  which  all  options  for  Single  Case 
data  entry*  modification,  and  execution  are  accessible.  The  options  are: 


(fT)  _  Generate  the  Tide  Elevation  Record. 

(fz|  .  General  Time  &  Output  Specifications. 

Constituent  Data  Entry.  \ 

Write  Tide  Record  to  current  plot  output  filename. 
Plot  the  Tide  Record, 

(fio)  Exit  Menu. 


Each  option  and  the  required  data  are  described  below. 


|Fl)  Generate  the  Tide  Elevation  Record 

Use  this  option  only  after  all  data  have  been  entered. 
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(F2)  General  Time  &  Output  Specifications 

This  screen  provides  for  input  of  general  parameters  required  to  run  the 
application.  Values  for  all  parameters  listed  except  Description  are  required. 


Item 

Units 

Data  Ranee 

Simulation  Start  Time: 

Year 

1900 

to 

2050 

Month 

I 

to 

12 

Day 

1 

to 

31 

Hour 

0 

to 

24 

Length  of  Record 

hr 

0 

to 

744 

Output  Time  Interval 

hr, min 

1 

to 

60 

Mean  Water  Level  Height  above 

ft,m 

-100 

to 

100 

Datum 


Description  alphanumeric 

CAUTION:  The  number  of  points  used  in  calculating  the  tide 
record  is  determined  by  dividing  the  Length  of  Record  by  the 
Output  Time  Interval.  A  maximum  of  1,500  points  are  allowed 
by  this  application.  If  this  maximum  is  exceeded,  an  error 
message  will  be  displayed  on  screen. 


NOTE:  When  all  required  data  have  been  entered  on  this  screen, 
press  [fio]  to  return  to  the  Activity  Menu. 


(F3)  Constituent  Data  Entry 

This  series  of  screens  provides  for  input  of  constituent  data  (amplitude  and 
epoch)  for  any  of  37  constituents.  The  major  tidal  constituents  accepted  by  this 
application  are  listed  in  Table  A-5  in  Appendix  A. 


Item 

Units 

Data  Ranee 

Gage  Longitude 

deg  West 

-180.0  to 

Amplitude  Units 

ft,m 

Amplitude  of  Individual 

ft,m 

0.0  to 

Constituent 
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Epoch  of  Individual 
Constituent,, 


deg 


0.0  to 


360.00 


!  ■ 


NOTE:  The  symbols  of  37  common  harmonic  constituents  (see 
Table  A-5  in  Appendix  A)  are  displayed  on  a  series  of' screens. 

Place  the  values  of  amplitude  and  epoch  by  the  appropriate  desired 
constituent  symbol.  ~ 

Press  Jpl)  to  continue  additional  constituent  input  on  subsequent 
screens.  When  finished  entering  all  data,  press  [Flo]  to  return  to 
the  Activity  Menu.  .  v 

The  number  of  constituents  needed  to  describe  the  astronomical  tide  varies  with 
the  location.  More  terms  are  needed  where  the  tide  must  travel  a  great  distance 
over  shallow  water  than  when  the  tide  station  is  near  the  open  sea.  Additional 
terms  may  be  needed  to  obtain  an  adequate  representation  when  the  tidal  range 
is  large  rather  than  small  (Harris,  1981).  In  the  United  States,  37  standards 
constituents  (Table  A-5,  Appendix  A)  are  found  to  be  adequate  for  most  tide 
stations  (Schureman,  1971).  These  harmonic  constituents  are  available  for  many 
US  locations  from  the  National  Ocean  Survey. 


[F4l  Write  Tide  Record  to  Plot  Output  File  1  - 

This  option  generates  a  plot  output  file  (default  name  PLOTDATl  .OUT) 
containing  tide  elevations  at  specific  times..  Plot  output  file  1  is  written,  in  the 
following  format  (see  Table  1-4-1  in  the  Example  Problem): 

Field  Columns  Format  Data 

1  1-8  F8!2  Time  in  hours  from  beginning  of 

simulation 

2  19-26  F8.2  Elevation  of  the  tide 


Plot  the  Tide  Record 


This  application  generates  one  plot  (see  Figure  1-4-1  in  the  Example  Problem) 
consisting  of  the  tide  elevation  against  time  for  the  Length  of  Simulation  specified 
on  the  General  Time  &  Output  Specifications  screen..  i  ... 
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Example  Problem 

Input 

(F2)  General  Time  &  Output  Specifications  Data  Entry 


Item 

Simulation  Start  Time: 

Value 

Units 

Year 

1989 

Month 

1 

Day 

10 

Hour 

10.00 

Length  of  Record 

120.00 

hr 

Output  Time  Interval 

15.00 

min 

Mean  Water  Height  above  Datum 

1.79 

ft 

Description  Buzzards  Bay  Entrance,  MA  (Datum  MLLW) 

(F3l  Constituent  Data  Entry 


Item 

Value 

Units 

Gage  Longitude 

70.62 

deg  West 

Amplitude  Units 

ft 

Constituents 

Amplitude 

Epoch 

m2 

1.621 

269.90 

s2 

0.303 

283.60 

n2 

0.447 

245.10 

Ki 

0.262 

114.00 

m4 

0.266 

136.70 

Oi 

0.221 

123.90 

m6 

0.070 

241.90 

mk3 

0.045 

138.00 

mn4 

0.113 

82.20 

nu2 

0.077 

262.20 

mu2 

0.070 

225.00 

2N2 

0.071 

225.70 

lambda2 

0.011 

276.30 

Si 

0.038 

55.30 

Mj 

0.016 

119.00 

Jl 

0.017 

109.00 

SSA 

0.037 

44.60 

(Constituent  Data  Entry  continued  on 

the  next  page) 
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(Constituent  Data  Entry  concluded) 


SA 

0.112 

151.60 

Qi 

0.045 

112.60 

t2  • 

0.018 

283.60 

■ 

0.091 

123.80 

l2 

0.045 

294.70 

2MK3 

0.039 

159.00 

k2 

0.091 

274.20 

ms4 

0:076 

231.00 

NOTE:  All  other  harmonic  constituents  are  0.0  for  this  example. 


Output 


Screen  Plot 

Figure  1-4-1  is  the  one  plot  generated  for  this  Example  Problem.  The  plot  may 
be  accessed  from  the  Activity  menu  screen  by  pressing  (fsI 
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Plot  Output  File  1 

In  addition  to  the  screen  plot,  the  data  can  be  sent  to  plot  output  file  1  (default 
name  PLOTDAT1  .OUT)  by  pressing  (F4).  This  file  contains  tide  elevations  at 
specific  times.  Table  1-4-1  is  a  listing  of  the  plot  output  file  1  for  the  Example 
Problem. 


Table  1-4-1 

Listing  of  Plot  Output  File  1  for 
Example  Problem 


CONSTITUENT  TIDE 
ELEVATION  RECORD 
Buzzards  Bay  Entrance,  MA 
(Datum  MLLW) 


TIME 

ELEVAT 

(hrs) 

(feet) 

0.00 

4.26 

0.25 

4.35 

0.50 

4.39 

0.75 

4.38 

1.00 

4.32 

4 

4 

118.50 

0.65 

118.75 

0.52 

119.00 

0.38 

119.25 

0.25 

119.50 

0.12 

119.75 

0.01 

120.00 

-0.08 
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Description 


.  .‘.'I 


This  application  yields  first-order  approximations  for  various  parameters  of  wave 
motion  as  predicted  by  the  wave  theory  bearing  the  same  name  (also  known  as 
small-amplitude,  sinusoidal,  or  Airy  theory).  It  provides  estimates  for  common  , 
items  of  interest  such  as  water  surface  elevation,  general  wave  properties,  particle 
kinematics,  and  pressure  as  functions  of  wave  height  and  period,  water  depth, 

;  and  position  in  the  wave  form. 


Input 


The  coordinate  system  and  terminology  used  to  define  linear  wave  motion  are 
shown  in  Figure  2-1-1.  iM‘ ■  :  -  :  1 


Bottom,  z  =  -h  ~  . 


Figure  2-1-1.  Small- Amplitude  Wave  System 


All  data  input  for  this  application  is  done  on  one  screen.  The  following  list 
describes  the  necessary  input  parameters 
of  data  recognized  by  this  application: 


Item 

SVmbol 

Units 

Daia  Range 

Wave  height 

Wave  period 

H 

ft,  m 

0.1 

to 

200.0 

t  •: 

,  ysec 

l.o 

to 

1000.0 

Water  depth 

d 

ftj  m 

0.1 

to 

5000.0 

Vertical  coordinate 

z 

ft,  m 

-5100.0 

to 

100.0 

Horizontal  coordinate  as  a 

X/L 

V 

0.0 

to 

1.0 

fraction  of  wavelength 
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Output 

Results  from  this  application  are  displayed  on  one  screen.  Those  data  include 
the  original  input  values  (in  final  units)  and  the  following  parameters: 


Item 

Svmbol 

English 

Metric 

Units 

Units 

Wavelength 

L 

ft 

m 

Wave  celerity 

C 

ft/sec 

m/sec 

Group  velocity 

Cg 

ft/sec 

m/sec 

Energy  density 

E 

ft-lb/ft2 

N-m/m2 

Energy  flux 

P 

ft-lb/sec-ft 

N-m/sec-m 

Ursell  number 

Ur 

Surface  elevation 

n 

ft 

m 

Horizontal  particle  displacement 

? 

ft 

m 

Vertical  particle  displacement 

i; 

ft 

m 

Horizontal  particle  velocity 

u 

ft/sec 

m/sec 

Vertical  particle  velocity 

w 

ft/sec 

m/sec 

Horizontal  particle  acceleration 

du/dt 

ft/sec2 

m/sec2 

Vertical  particle  acceleration 

dw/dt 

ft/sec2 

m/sec2 

Pressure 

P 

lb/ft2 

N/m2 

Procedure 

The  bulleted  items  in  the  following  lists  indicate  potentially  optional  instruction 
steps.  Any  application  in  ACES  may  be  executed  in  a  given  session  without 
quitting  the  program.  The  bulleted  items  provide  instructions  for  accessing  the 
application  from  various  menu  areas  of  the  ACES  program.  Ignore  bulleted 
instruction  that  are  not  applicable. 

Single  Case  Mode 

°  Press  (fT)  on  the  Main  Menu  to  select  Single  Case  Mode. 

°  Fill  in  the  highlighted  input  fields  on  the  General  Specifications  screen 
(or  leave  the  default  values).  Press  (fT)  when  all  data  on  this  screen 
are  correct. 

°  Press  [F2]  on  the  Functional  Area  Menu  to  select  Wave  Theory. 

Press  @  on  the  Wave  Theory  Application  Menu  to  select  Linear  Wave 
Theory. 
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Fill  in  the  highlighted  input  fields  on  the  Linear  Wave  Theory  screen.  Respond 
to  any  corrective  instructions  appearing  at  the  bottom  of  the  screen.  Press 
(fi)  when  all  data  on  this  screen  are  correct. 

AH  input  and  output  data  are  displayed  on  the  screen  in  the  final  system  of 

units.;..-:;-'-.,  :  -..v  -.  ' 

Press  one  of  the  following  keys  to  select  the  appropriate  action: 

IrT)  Return  to  Step  1  for  a  new  case. 

(F3]  Send  a  summary  of  this  case  to  the. print  file  or  device. 

'  '  [Fioj  Exit  this  application  and  return  to  the  Wave  Theory 
Application  Menu. 

Multiple  Case  Mode 

*  Press  (F2)  on  the  Main  Menu  to  select  Multi  Case  Mode. 

°  Fill  in  the  highlighted  input  fields  on  the  General  Specifications  screen 
(or  leave  the  default  values).  Press  iFl)-  when  all  data  on  this  screen 
v  are  correct. 

0  Press  (F2)  on  the  Functional  Area  Menu  to  select  Wave  Theory. 

°  Press  (fT)  on  the  Wave  Theory  Application  Menu  to  select  Linear  Wave 
Theory.  ^  v  , 

1.  Move  the  cursor  to  select  a  variable  on  the  Linear  Wave  Theory  screen  (the 
selected  variable  name  blinks).  The  current  set  of  values  for  the  variable  is 
displayed  on  the  right  portion  of  the  screen.  When  all  variable  sets  are 
correct,  go  to  Step  3. 

2.  Enter  a  set  of  values  for  the  subject  variable  by  following  one  of  the  input 

.  methods:  ■  ‘ 

a.  Press  ©  to  select  random  method.  Enter  up  to  20  values  constituting 
a  set  for  this  variable  (one  in  each  field)  on  the  right  side  of  the  screen. 
The  set  of  20  values  originally  displayed  (first  execution)  in  these  fields 
contains  the  "delimiting"  value,  which  "delimits"  or  "ends"  the  set.  The 
"delimiting"  value  is  not  included  as  a  member  in  the  set  unless  it  is 
the  sole  member. 

b.  Press  03  to  select  incremental  method.  Fill  in  the  fields  for  minimum, 
maximum,  and  increment  values  for  this  variable  on  the  right  side  of 
the  screen.  In  this  method,  the  members  of  the  set  include  all  values 
from  the  minimum  to  the  maximum  (both  inclusive)  at  the  specified 
increment. 

The  units  field  should  also  be  specified  for  the  variable  regardless  of  input 
method.  All  members  of  a  set  of  values  for  a  subject  variable  are  assigned 
the  specified  units.  When  all  data  are  correct  for  the  subject  variable,  press 
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[pJo]  to  return  to  Step  1 .  Errors  are  reported  at  the  bottom  of  the  screen 
and  are  corrected  by  pressing  (fT)  to  allow  respecification  of  the  data  for  the 
subject  variable. 

3.  Press  (fT)  to  process  the  cases  resulting  from  the  combinations  of  the  sets  of 
data  for  all  variables.  The  summary  of  each  case  will  be  sent  to  the  print 
file  or  device.  The  screen  will  display  the  total  number  of  cases  to  be 
processed  as  well  as  report  progress.  Errors  are  reported  at  the  bottom  of 
the  screen  and  are  corrected  by  pressing  (fT|  to  allow  respecification  of 
variable  sets. 

4.  Press  one  of  the  following  keys  to  select  the  appropriate  action: 

[fT|  Return  to  Step  1  to  specify  new  sets. 

[Flo]  Exit  this  application  and  return  to  the  Wave  Theory 
Application  Menu. 


Example  Problem 


Input 

All  data  input  for  this  application  is  done  on  one  screen.  The  values  and 
corresponding  units  selected  for  this  example  are  shown  below. 


Item 

Symbol 

Value 

Units 

Wave  height 

H 

6.30 

ft 

Wave  period 

T 

8.00 

sec 

Water  depth 

d 

20.00 

ft 

Vertical  coordinate 

z 

-12.00 

ft 

Horizontal  coordinate  as  a 

X/L 

0.75 

fraction  of  wavelength 


Output 

Results  from  this  application  are  displayed  on  one  screen.  Those  data  include 
the  original  input  values  and  the  following  parameters  (refer  to  Figure  2-1-2 
for  location  of  the  parameters): 


Item 

Svmbol 

Value 

Units 

Wavelength 

L 

189.90 

ft 

Wave  celerity 

C 

23.74 

ft/sec 
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Group  velocity 

20.87 

ft/sec 

Energy  density 

E 

317.45 

ft- lb/ft2 

Energy  flux 

P 

6625.07  • 

ft-lb/sec-ft 

Ursell  number 

Ur 

28,40 

Surface  elevation 

il 

0.00 

ft 

Horizontal  particle  displacement 

S 

4.59 

ft 

Vertical  particle  displacement 

0.00 

ft 

Horizontal  particle  velocity 

u 

0.00 

ft/sec 

Vertical  particle  velocity 

w 

1 

O 

UJ 

ft/sec 

Horizontal  particle  acceleration 

in/ St 

-2.83 

ft/sec2 

Vertical  particle  acceleration 

iw/it 

0.00 

ft/sec2 

Pressure 

P 

767.83 

lb/ft2 
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Cnoidal  Wave  Theory  


Description 

This  application  yields  various  parameters  of  wave  motion  as  predicted  by 
first-order  (Isobe,  1985)  and  second-order  (Hardy  and  Kraus,  1987) 
approximations  for  cnoidal  wave  theory.  It  provides  estimates  for  common  items 
of  interest  such  as  water  surface  elevation,  general  wave  properties,  kinematics, 
and  pressure  as  functions  of  wave  height  and  period,  water  depth,  and  position 
in  the  wave  form. 


Input 


The  coordinate  system  and  terminology  used  to  define  cnoidal  wave  motion  is 
shown  in  Figure  2-2-1.  ...  ■■ 


All  data  input  for  this  application  is  done  on  one  screen.  The  following  list 
describes  the  necessary  input  parameters  with  their  corresponding  units  and  range 
of  data  recognized  by  this  application:  .  h . 


j 

Item- 

Symbol 

Units 

Data  Ranee 

i 

•  1 
! ' 

■  Wave  height  j.. 

ft,  m 

0.1 

to 

200.0 

:  i 
.i 

Wave  period 

T 

,  sec 

1.0 

to 

1000.0 

■  r  • 

t 

Water  depth 

d 

ft,  m 

0.1  ' 

to 

5000.0 

i 

i  • 

i 

Vertical  coordinate 

2 . 

ft,  m 

-5100.0 

to 

100.0 

• 

1 
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Horizontal  coordinate  as  a  X/L 
fraction  of  wavelength 
Order  approximation 


0.0  to  1.0 

1  or  2 


Output 

Results  from  this  application  are  written  to  one  screen.  In  addition,  there  is  an 
option  (available  in  Single  Case  Mode  only)  to  send  data  to  plot  output  file  1 
(default  name  PLOTDATl.OUT).  This  application  also  generates  three  screen 
plots.  The  three  plots  are  described  in  the  Procedure  section  of  this  document. 
The  screen  output  and  the  content  of  plot  output  file  1  'are  described  below 
(refer  to  the  Example  Problem  section  for  a  paradigm). 


Screen  Output 

Results  which  are  displayed  on  one  screen  include  the  original  input  values  (in 
final  units)  and  the  following  parameters: 


Item 

Symbol 

English 

Units 

Metric 

Units 

Wavelength 

L 

ft 

m 

Wave  celerity 

C 

ft/sec 

m/sec 

Energy  density 

E 

ft-lb/ft2 

N-m/m2 

Energy  flux 

Ursell  number 

P 

HL2/d 3 

ft-lb/sec-ft 

N-m/sec-m 

Surface  elevation 

ti 

ft 

m 

Horizontal  velocity 

u 

ft/sec 

m/sec 

Vertical  velocity 

w 

ft/sec 

m/sec 

Horizontal  acceleration 

du/it 

ft/sec2 

m/sec2 

Vertical  acceleration 

dw/dt 

ft/sec2 

m/sec2 

Pressure 

p 

lb/ft2 

N/m2 

Plot  Output  File  1 

Plot  output  file  1  contains  water  surface  and  velocity  values  across  two 
wavelengths.  The  format  of  the  file  is  described  below. 
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Field 

Columns 

Format 

Data 

i: 

1-10  . 

FI  0.3 

( X/L )  horizontal,  coordinate  as  a  fraction 

of  wavelength 

2 

U-20 

FI  0.3 

(q)  water  surface  elevation 

3 

21-30 

F10.3 

(«)  horizontal  component  of  the  water 

velocity 

4 

31-40 

F10.3 

(w)  vertical  component  of  the  water 

V  # 1 " 

•:  '•  "  ‘  V 

'•Vi..--  "V 

velocity  ? 

Procedure 

-  ''j 

•  '  ; 

-s-,-  .<  :  ,  y  ^ ■  ;.  W  •/  t 

The  bulleted  items  in  the  following  lists  indicate  potentially  optional  instruction 
steps.  Any  application  in  ACES  may  be  . executed  in  a  given  session  without 
quitting  the  program.  The  bulleted  items  provide  instructions  for  accessing  the 
application  from  various  menu  areas  of  the  ACES  program.  Ignore  bulleted 
instruction  steps  that  are, not  applicable. 

Single  Case  Mode 

°  Press  (Fi)  on  the  Main  Menu  to  select  Single  Case  Mode. 

°  Fill  in  the  highlighted  input  fields  on  the  General  Specifications  screen 
(or  leave  the  default  values).  Press  (fi)  when  all  data  on  this  screen 
are  correct. 

0  Press  (f§)  on  the  Functional  Area  Menu  to  select  Wave  Theory. 

°  Press  (F2)  on  the  Wave  Theory  Application  Menu  to  select  Cnoidal 
Wave  Theory. 

1.  Fill  in  the  highlighted  input  fields  on  the  Cnoidal  Wave  Theory  screen. 
Respond  to  any  corrective  instructions  appearing  at  the  bottom  of  the  screen. 
Press  [Ft)  when  all  data  on  this  screen  are  correct. 

2.  All  input  and  output  data  are  displayed  on  the  screen  in  the  final  system  of 

’  units.  V...  v,;/:  ■ 

3.  Press  one  of  the  following  keys  to  select  the  appropriate  action: 

(Ft)  Return  to  Step  1  for  a  new  case. 

(F2|  Invoke  the  Plot  Menu  screen  (see  the  following  section  titled 

Cnoidal  Wave  Theory  Plot  Menu). 

(F3]  Send  a  summary  of  this  case  to  the  print  file  or  device. 

(F4)  Generate  a  file  containing  plot  data  (Plot  Output  File  1). 
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[fio]  Exit  this  application  and  return  to  the  Wave  Theory 
Application  Menu. 


Cnoidal  Wave  Theory  Plot  Menu 

This  application  generates  three  plots.  The  plots  may  be  accessed  from  the 
CNOIDAL  WAVE  THEORY  PLOT  MENU,  which  appears  when  the  Plot  Data 
option  ((F2)  key)  on  the  data  output  screen  is  selected.  To  access  a  plot,  move 
the  cursor  (using  the  arrow  keys)  to  the  desired  selection  on  the  menu  and  press 
m.  (Appendix  C  describes  options  to  customize  plots.)  Available  selections 
are: 

Water  Surface  Elevation  (see  Figure  2-2-3) 

°  Horizontal  Velocity  (see  Figure  2-2-4) 

°  Vertical  Velocity  (see  Figure  2-2-5) 

°  ALL  PLOTS 

NOTE:  This  option  will  make  all  the  plots  available 
for  viewing.  Use  the  NEXT  option  of  the  graphics 
package  (Appendix  C)  to  view  each  plot 
successively. 

°  EXIT  MENU 

Multiple  Case  Mode 

°  Press  (F2]  on  the  Main  Menu  to  select  Multi  Case  Mode. 

Fill  in  the  highlighted  input  fields  on  the  General  Specifications  screen 
(or  leave  the  default  values).  Press  (fi)  when  all  data  on  this  screen 
are  correct. 

Press  (F2)  on  the  Functional  Area  Menu  to  select  Wave  Theory. 

°  Press  (F2)  on  the  Wave  Theory  Application  Menu  to  select  Cnoidal 
Wave  Theory. 

1 .  Move  the  cursor  to  select  a  variable  on  the  Cnoidal  Wave  Theory  screen  (the 
selected  variable  name  blinks).  The  current  set  of  values  for  the  variable  is 
displayed  on  the  right  portion  of  the  screen.  When  all  variable  sets  are 
correct,  go  to  Step  3. 

2.  Enter  a  set  of  values  for  the  subject  variable  by  following  one  of  the  input 
methods: 
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a.  Press  ®  to  select  random  method.  Enter  up  to  20  values  constituting 

a  set  for  this  variable  (one  in  each  field)  on  the  right  side  of  the  screen. 
The  set  of  20  values  originally  displayed  (first  execution)  in  these  fields 
contains  the  "delimiting"  value,  which  "delimits"  or  "ends"  the  set.  The 
"delimiting"  value  is  nor  included  as  a  member  in  the  set  unless  it  is 
the  sole  member.  :  r ■ 

b.  Press  (T)  to  select  incremental  method.  Fill  in  the  fields  for  minimum, 
maximum,  and  increment  values  for  this  variable  on  the  right  side  of 
the  screen.  In  this  method,  the  members  of  the  set  include  all  values 
from  the  minimum  to  the  maximum  (both  inclusive)  at  the  specified 
increment. 

The  units  field  should  also  be  specified  for  the  variable  regardless  of  input 
method.  All  members  of  a  set  of  values  for  a  subject  variable  are  assigned 
the  specified  units.  When  all  data  are  correct  for  the  subject  variable,  press 
[no]  to  return  to  Step  1.  Errors  are  reported  at  the  bottom  of  the  screen 
and  are  corrected  by  pressing  (fT)  to  allow  respecification  of  the  data  for  the 
•subject  variable.  '■  ‘v" 7"‘  '  ,r  '  '  •:  ••  ' 

3.  Press  (n]  to  process  the  cases  resulting  from  the  combinations  of  the  sets  of 

data  for  all  variables.  The  summary  of  each  case  will  be  sent  to  the  print 
file  or  device.  The  screen  will  display  the  total  number  of  cases  to  be 
processed  as  well  as  report  progress^  Errors  are  reported  at  the  bottom  of 
the  screen  and  are  corrected  by  pressing  (ft)  to  allow  respecification  of 
variable  sets.  -  -  .  v  ..  V 

4.  Press  one  of  the  following  keys  to  select  the  appropriate  action: 

Return  to  Step  1  to  specify  new  sets. 

Exit  this  application  and  return  to  the  Wave  Theory 
Application  Menu.  .  -  .;■■■■■ 


(ED 

(™D 


NOTE:  Multiple  Case  Mode  does  not  generate  any  plot  output 
files  or  plots. 

Example  Problems 

Example  1  -  First-Order.  Approximation 


Input 


All  data  input  for  this  application  is  done  on  one  screen.  The  values  and 
corresponding  units  selected  for  this  “first  example  are  shown  below. 
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Item 

Svmbol 

Value 

Units 

Wave  height 

H 

10.00 

ft 

Wave  period 

T 

15.00 

sec 

Water  depth 

d 

25.00 

ft 

Vertical  coordinate 

z 

-12.50 

ft 

Horizontal  coordinate  as  a 
fraction  of  wavelength 

X/L 

0.50 

Output 

Results  from  this  application  are  written  to  one  screen  and,  if  requested,  to  plot 
output  file  I  (default  name  PLOTDATl.OUT).  In  addition,  three  screen  plots 
are  generated.  Each  of  these  outputs  for  the  example  problem  is  presented  below. 


Screen  Output 

Results  from  this  application  are  displayed  on  one  screen.  Those  data  include 
the  original  input  values  and  the  following  parameters  (see  Figure  2-2-2): 


Item 

Svmbol 

Value 

Units 

Wavelength 

L 

455.74 

ft 

Wave  celerity 

C 

30.38 

ft/sec 

Energy  density 

E 

621.52 

ft-lb/ft2 

Energy  flux 

P 

17625.85 

ft-lb/sec-ft 

Ursell  number 

HL2/d 3 

132.93 

Surface  elevation 

T| 

-2.14 

ft 

Horizontal  velocity 

u 

-2.43 

ft/sec 

Vertical  velocity 

w 

0.00 

ft/sec 

Horizontal  acceleration 

3u/it 

0.00 

ft/sec2 

Vertical  acceleration 

dw/dt 

0.01 

ft/sec2 

Pressure 

P 

643.23 

Ib/ft2 
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Plot  Output  File  1 

Table  2-2-1  below  is  a  partial  listing  of  plot  output  file  1  generated  (if  requested) 
by  this  application  for  the  example  problem. 


Table  2-2-1 

Partial  Listing  of  Plot  Output  File  1  for  Example 
Problem  1 


X/L 

ETA  (ft) 

U  (ft/sec) 

W  (ft/sec) 

-1.000 

7.860 

J  8.917 

0.000 

-0.992 

7,805 

8.854 

0.430 

-0.984 

7.641 

8.668 

0.841 

-0.976 

7.376 

8.367 

1.216 

-0.968 

7.020 

7.963 

1.541 

-0.960 

6.588 

7.474 

1.807 

-0.952 

6.096  , 

6.916 

2.008 

l 

1 

l 

11 

0.952 

6.096 

'  6.916 

-2.008 

0.960 

6.588 

:  7.474 

-1.807 

0.968 

7.020 

7.963 

-1.541 

0.976 

7.376 

■  8.367 

-1.216 

0.984 

7.641 

8.668 

-0.841 

0.992 

7.805 

8.854 

-0.430 

Screen  Plots 

This  application  generates  three  screen  plots.  Figures  2-2-3  through  2-2-5  are 
plots  of  the  water  surface  elevation  (ETA)  and  the  horizontal  (U)  and  vertical 
(W)  water  velocity  as  a  function  of  the  horizontal  coordinate  (X/L). 
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Example  2  -  Second-Order  Approximation 
Input 

All  data  input  for  this  application  is  done  on  one  screen.  The  values  and 
corresponding  units  selected  for  this  second  example  are  shown  below. 


Item  .  Symbol  Value  Units 

Wave  height  H  10.00  ft 

Wave  period  T  15.00  sec 

Water  depth  d  25.00  ft 

Vertical  coordinate  z  -12.50  ft 

Horizontal  coordinate  as  a  X/L  0.50 

fraction  of  wavelength 


Output 

Results  from  this  application  are  written  to  one  screen  and,  if  requested,  to  plot 
output  file  1  (default  name  PLOTDATl.OUT).  In  addition,  three  screen  plots 
are  generated.  Each  of  these  outputs  for  the  example  problem  is  presented  below. 

Screen  Output 

Results  from  this  application  are  displayed  on  one  screen.  Those  data  include 
the  original  input  values,  and  the  following  parameters  (see  Figure  2-2-6): 


Item 

Svmbol 

Value 

Units 

Wavelength 

L 

445.78 

ft 

Wave  celerity 

C 

29.72 

ft/sec 

Energy  density 

E  . 

614.59 

ft-lb/ft2 

Energy  flux 

P 

17154.86  . 

ft-lb/sec-ft 

Ursell  number 

HL2/d3 

127.18 

Surface  elevation 

h 

-2.03 

ft 

Horizontal  velocity 

u 

-2.70 

ft/sec 

Vertical  velocity 

w 

o.oo  : 

ft/sec 

Horizontal  acceleration 

du/dl  ; 

0.00  ; 

ft/sec2 

Vertical  acceleration  • 

dw/dt 

0.01 

ft/sec2 

Pressure 

p 

673.11 

lb/ft2 
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Figure  2-2-6.  Cnoidal  Theory  (Second-Order  Approximation)  Example  Output 

Plot  Output  File  1 

Table  2-2-2  below  is  a  partial  listing  of  plot  output  file  1  generated  (if  requested) 
by  this  application  for  the  second  example  problem, 


Table  2-2-2 

Partial  Listing  of  Plot  Output  File  1  for  Example 
Problem  2 


X/L 

ETA  (ft) 

-1.000 

7.972 

-0.992 

7.907 

-0.984 

7.716 

-0.976 

7.408 

-0.968 

7.000 

-0.960 

6.510 

-0.952 

5.959 

-0.944 

5.369 

-0.936 

4.761 

11 

1 

0.944 

5.369 

0.952 

5.959 

0.960 

6.510 

0.968 

7.000 

0.976 

7.408 

0.984 

7.716 

0.992 

7.907 

U  (ft/sec) 

W  (ft/sec) 

6.601 

0.000 

6.564 

0.177 

6.455 

0.355 

6.277 

0.533 

6.033 

0.708 

5.730 

0.879 

5.374 

1.040 

4:975 

1.185 

4.542 

1.309 

I 

4 

4.975 

-1.185 

5.374 

-1.040 

.  5.730 

-0.879 

6.033 

-0.708 

6.277 

-0.533 

6.455 

-0.355 

6.564 

-0.177 

Screen  Plots 

This  application  generates  three  screen  plots.  Figures  2-2-7  through  2-2-9  are 
plots  of  the  water  surface  elevation  (ETA)  and  the  horizontal  (U)  and  vertical 
(W)  water  velocity  as  a  function  of  the  horizontal  coordinate  (X/L). 
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Fourier  Series  Wave  Theory 


Description 


This  application  yields  various  parameters  for  progressive  waves  of  permanent 
form,  as  predicted  by  Fourier  series  approximation.  It  provides  estimates  for 
common  engineering  parameters  such  as  water  surface  elevation,  integral  wave 
properties,  and  kinematics  as  functions  of  wave  height,  period,  water  depth,  and 
position  in  the  wave  form  which  is  assumed  to  exist  on  a  uniform  co-flowing 
current.  Stokes  first  and  second  approximations  for  celerity  (i.e.,  values  of  the 
mean  Eulerian  current  or  mean  mass  transport  rate)  may  be  specified.  Fourier 
series  of  up  to  25  terms  may  be  selected  to  approximate  the  wave.  In  addition 
to  providing  kinematics  at  a  given  point  in  the  wave,  this  application  provides 
graphical  presentations  of  kinematics  over  two  wavelengths  (at  a  given  z 
coordinate),  and  the  vertical  profile  of  selected  kinematics  under  the  wave  crest. 
The  methodology  is  based  upon  a  series  of  papers  by  J.  D.  Fenton  (Reinecker 
and  Fenton;  1981;  Fenton,  1988a;  Fenton,  1988b;  Fenton,  1990)  and  R.  J.  Sobey 
(Sobey,  Goodwin,  Thieke,  and  Westberg,  1987).  LINPACK  routines  (Dongarra 
et  al.,  1979)  are  used  to  solve  the  set  of  up  to  60  simultaneous  equations  to 
determine  the  Fourier  coefficients  for  the  series. 


Procedure 


This  section  provides  instructions  for  running  this  application  in  the  Single  Case 
mode.  The  Multiple  Case  mode  is  not  available.  1 


Press  (Ft)  on  the  Main  Menu  to  select  Single  Case  Mode. 

Fill  in  the  highlighted  input  fields  on  the  General  Specifications  screen 
(or  leave  the  default  values).  Press  (fT)  when  all  data  on  this  screen 
are  correct.  i-.-  i-*  ; 

Press  [f2]  on  the  Functional  Area  Menu  to  select  Wave  Theory. 


Press  [F3]  on  the  Wave  Theory  Application  Menu  to  select  Fourier 
Series  Wave  Theory^ . 
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Input 

The  coordinate  system  and  terminology  used  to  define  Fourier  series  wave  motion 
are  shown  in  Figure  2-3-1. 


z 


Figure  2-3-1.  Progressive  Fourier  Series  Wave  System 


Initial  data  input  for  this  application  is  done  on  one  screen.  The  following  list 
describes  the  necessary  input  parameters  with  their  corresponding  units  and  range 


of  data  recognized  by  this  application: 


Item  Symbol 

Wave  height  H 

Wave  period  T 

Water  depth  d 

Celerity  Definition 
Mean  Velocity  u 


Number  of  terms  in 
Fourier  Series 
Number  of  steps  in  Wave 
Height  ramping 


Units  Data  Ranee 


ft,  m 

0.1 

to 

200.0 

sec 

1.0 

to 

1000.0 

ft,  m 

0.1 

to 

5000.0 

E(Euler) 

or 

S(Stokes) 

fps,  mps 

1.0 

to 

10.0 

1 

to 

25 

1 

to 

10 

In  addition  to  the  above  input  the  user  has  the  option  to  request  kinematics 
(horizontal  and  vertical  velocity  and  acceleration,  pressure,  and  water  surface 
elevation)  at  a  selected  point  of  interest.  This  option  is  presented  to  the  user 
only  after  computations  are  performed  using  the  above  initial  input  values.  The 
option  to  get  kinematics  is  offered  on  the  second  screen  displaying  output  and 
is  described  in  a  later  section. 
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When  the  required  input  data  on  the  screen  are  correct,  press  one  of  the  following 
keys  to  select  the  next  appropriate  action: 

(Fj)  Perform  computations. 

[Flo]  Exit  this  application  ,  and  return  to  the  Wave  Theory 
Application  Menu, 

Output  ■  ,;tr .  ,/. 

Results  from  this  application  are  displayed  on  two  screens.  In  addition,  there 
is  an  option  to  send  data  to  plot  output  file  1  (default  name  PLOTDATl.OUT). 
This  application  also  generates  nine  screen  plots.  These  various  outputs  are 
described  in  the  following  sections. 

Screen  Output 

First  Screen 

Results  which  are  displayed  on  the  first  screen  include  the  original  input  values 
(in  final  units)  and  the  following  parameters: 


Item 

Symbol 

English 

Units  - 

Metric 

Units 

Celerity 

ft/sec 

m/sec 

Wavelength 

ft 

m 

Mean  Eulerian  Fluid  Velocity 

ft/sec 

m/sec 

Mean  Mass  Transport  Velocity 

ft/sec 

m/sec 

Mean  Velocity  relative  to  Wave 

ft/sec 

m/sec 

Volume  Flux 

ft2/sec 

m2/sec 

Bernoulli  Constant 

ft2/sec2 

m2/sec2 

Impulse 

/ 

lb -sec/ft2 

N-sec/m2 

Kinetic  Energy 

ek 

ft-lb/ft2 

N-m/m2 

Potential  Energy 

ep 

ft-lb/ft2 

N-m/m2 

Energy  density  >  , 

-  ek+ev 

ft-lb/ft2 

N-m/m2 

Mean  Square  of  Bed  Velocity 

ft2/sec2 

m2/sec2 

Radiation  Stress 

,  '  Exx 

ft-ib/ft2 . 

N-m/m2 

Wave  Power  (Energy  flux) 

; f"": 

ft-lb/sec-ft 

N-m/sec-m 

Volume  Flux 

Q 

ft2/sec 

m2/sec 

Bernoulli  Constant 

R 

ft2/sec2 

m2/sec2 

■  .  n 
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After  viewing  the  first  output  screen  press  one  of  the  following  keys  to  select 
the  next  appropriate  action: 

(fT)  Return  to  the  input  screen  for  a  new  case. 

[F2]  Send  a  summary  of  this  case  to  the  print  file  or  device. 

(F5)  Invoke  the  next  screen  to  view  additional  output  results  and 
request  kinematics  at  a  particular  point  of  interest. 

[fio]  Exit  this  application  and  return  to  the  Wave  Theory 
Application  Menu. 

Second  Screen 

Results  displayed  on  the  second  screen  include  the  wave  surface  elevations  at 
the  crest  and  trough,  the  dimensionless  Fourier  coefficients,  and  if  desired ,  the 
following  kinematics  at  a  selected  point  of  interest. 


Velocity  (horizontal  and  vertical) 
Acceleration  (horizontal  and  vertical) 
Pressure 

Water  surface  elevation 


u,  w 

ft/sec 

m/sec 

Ox. 

ft/sec2 

m/sec2 

P 

lb/ft2 

N/m2 

r\ 

ft 

m 

After  viewing  the  second  output  screen,  press  one  of  the  following  keys  to  select 
the  next  appropriate  action: 

0  Invoke  the  requestor  for  entering  the  coordinates  where 
kinematics  are  desired. 

(fT)  Return  to  Previous  Screen. 

(fio]  Exit  this  application  and  return  to  the  Wave  Theory 
Application  Menu. 


When  0  is  pressed,  a  requestor  is  displayed  requesting  the  point  of  interest 
where  kinematics  are  desired.  Enter  a  horizontal  ( X/L )  and  vertical  Z  coordinate 
where  kinematics  are  desired.  The  horizontal  coordinate  is  entered  as  a  fraction 
of  the  wavelength  where  1.0  is  the  crest  and  0.5  is  the  trough.  The  vertical 
coordinate  is  entered  as  a  distance  below  the  wave  surface.  After  the  coordinates 
are  entered  press  [/yit)(o)  to  accept  the  values  and  make  the  computations,  or 
press  (Ait][Fio]  to  exit  the  requestor  and  return  to  the  previous  screen. 
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After  the  kinematic  computations  have  been  performed  and  displayed  press  one 
of  the  following  keys  to  select  the  next  appropriate  action: 

;  •  ©  Return  to  Previous  Screen.  T  . 

,  (fz)  Invoke  the  Plot  Menu  screen  (see  section  Screen  Plots). 

(f3  1  Print  the  Kinematics.  . 

(f4]  Generate  a  file  containing  plot  data  (see  section  Plot  Output 

}  .  ■  File  1):  V"  ■?./.'/ ' /y  •): 

(F5]  Invoke  requestor  for  new  kinematics  location. 

|fio)  Exit  this  application  and  return  to  the  Wave  Theory 
Application  Menu. 

Plot  Output  File  1 


Plot  output  file  f  contains  two  sections.  The  first  section  includes  horizontal 
and  vertical  velocity  and  acceleration,  pressure,  and  water  surface  elevation  at 
Z  as  a  function  of  the  horizontal  coordinate  (X/L).  The  second  section  contains 
the  horizontal  velocity,  vertical  acceleration,  and  pressure  under  the  wave  crest. 


Section  1  of  the  plot  output  file  1 


Kinematics  at  Z  (across  two  wavelengths) 


Field 

Columns 

Format 

Data 

1 

1-10 

FI  0.3 

counter  \:v /■’ 

.  2w-: 

11-20 

FI  0.3 

(X/L)  horizontal  coordinate  as  a  fraction 
of  wavelength 

i:C 

21-30 

,  F10.3 

(q)  water  surface  elevation 

4 

31-40 

FI  0.3 

({/)  horizontal  component  of  water  velocity 

:  /V;r5 

:  41-50 

FI  0.3 

(IF)  vertical  component  of  water  velocity 

6 

51-60 

F10.3 

(p)  pressure 

7 

61.-70 

F10.3 

(ax)  horizontal  acceleration 

8  • 

71-80 

F10.3 

(az)  vertical  acceleration 

Section, 2  of  the  plot  output  file  1 

Kinematics  Under  Wave  Crest 

Field 

Columns 

Format 

Data 

1 

1-10 

F10.3 

counter 

.  2 

11-20 

F10.3 

(Z)  vertical  coordinate  under  wave  crest 

3 

21-30 

F10.3 

(ti)  water  surface  elevation 

4 

31-40 

F10.3 

(U)  horizontal  component  of  water  velocity 

5  ■  - 

41-50 

F10.3 

(p)  pressure 

6 

51-60 

FI  0.3 

(fl„)  vertical  acceleration 
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Screen  Plots 


This  application  generates  nine  plots.  The  plots  may  be  accessed  from  the 
FOURIER  SERIES  WAVE  THEORY  PLOT  MENU  (KINEMATICS),  which 
appears  when  the  Plot  Data  option  ((Fg)  key)  on  the  second  data  output  screen 
is  selected.  To  access  a  plot,  move  the  cursor  (using  the  arrow  keys)  to  the 
desired  selection  on  the  menu  and  press  (fi).  (Appendix  C  describes  options  to 
customize  plots.)  Available  selections  are: 


(at  Z)  Across  Two  Wavelengths 

Horizontal  Velocity  (see  Figure  2-3-2  of  Example  Problem) 
Vertical  Velocity  (see  Figure  2-3-3  of  Example  Problem) 
Horizontal  Acceleration  (see  Figure  2-3-4  of  Example  Problem) 
Vertical  Acceleration  (see  Figure  2-3-5  of  Example  Problem) 
Pressure  (see  Figure  2-3-6  of  Example  Problem) 

Water  Surface  Elevation  (see  Figure  2-3-7  of  Example  Problem) 
Under  Wave  Crest 

Horizontal  Velocity  (see  Figure  2-3-8  of  Example  Problem) 
Vertical  Acceleration  (see  Figure  2-3-9  of  Example  Problem) 

"  Pressure  (see  Figure  2-3-10  of  Example  Problem) 


“  ALL  PLOTS 

NOTE:  This  option  will  make  all  the  plots  available 
for  viewing.  Use  the  NEXT  option  of  the  graphics 
package  (Appendix  C)  to  view  each  plot 
successively. 

°  EXIT  MENU 
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Problem 


Input 


Series 

Number  of  steps  in  Wave 
Height  ramping 


Output 


Initial  data  input  for  this  application  is  done  on 

one  screen. 

The  following  list 

describes  the  necessary  input  parameters  with  their  corresponding  units  and  range 

of  data  recognized  by  this  application: 

....  1 

Item 

Svmbol 

Value 

t  . 

L 

nits 

Wave  height 

H 

4.50 

ft 

Wave  period 

T 

9.00 

;ec 

Water  depth 

d 

22.00 

ft 

Celerity  Definition 

...  • 

E(Euler) 

Mean  Velocity 

u 

0.00 

f  t/s 

Number  of  terms  if  Fourier 

;•  " 

16 

1 

'  ,  *  1 
'  1 

Results  from  this  application  are  displayed  on  two  screens.  In  addition,  there 
is  an  option  to  send  data  to  plot  output  file  1  (default  name  PLOTDAjTl  .OUT). 
This  application  also  generates  nine  screen  plots.  The  plots  are  described  in  the 
Procedure  section  of  this  document.  The  screen  output  and  the  content  of  plot 
output  file  1  are  described  below  (refer  to  the  Example  Problem  secjtion  for  a 
paradigm). 
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Screen  Output 

First  Screen 

Results  which  are  displayed  on  the  first  screen  include  the  original  input  values 
(in  final  units)  and  the  following  parameters: 


Item 

Svmbol 

Value 

Units 

Celerity 

25.620 

ft/sec 

Wavelength 

230.581 

ft 

Mean  Eulerian  Fluid  Velocity 

0.000 

ft/sec 

Mean  Mass  Transport  Velocity 

0.140 

ft/sec 

Mean  Velocity  relative  to  Wave 

25.620 

ft/sec 

Volume  Flux 

3.088 

ft2/sec 

Bernoulli  Constant 

329.518 

ft2/sec2 

Impulse 

/ 

0.6141 1E+01 

lb-sec/ft2 

Kinetic  Energy 

78.667 

ft-lb/ft2 

Potential  Energy 

EP 

77.306 

ft- lb/ft2 

Energy  density 

EK+EP 

155.97 

ft-lb/ft2 

Mean  Square  of  Bed  Velocity 

uh2 

2.6479 

ft2/sec2 

Radiation  Stress 

■S' XX 

198.62 

ft-lb/ft2 

Wave  Power  (Energy  flux) 

F 

3577.6 

ft-lb/sec-ft 

Volume  Flux 

Q 

560.55 

ft2/sec 

Bernoulli  Constant 

R 

1037.3 

ft2/sec2 

Second  Screen 

Results  displayed  on  the  second  screen  include  the  wave  surface  elevations  at 
the  crest  and  trough,  the  dimensionless  Fourier  coefficients,  and  if  desired,  the 
following  kinematics  at  the  selected  point  of  interest. 


Point  of  interest 

(x/L,  Z) 

Horizontal 

0.000 

Vertical 

-5.000  ft 

Velocity  (horizontal  and  vertical) 

U,  W 

3.150 

0.000 

ft/sec 

Acceleration 

(horizontal  and  vertical) 

ax>  az 

0.000 

-1.302 

ft/sec2 

Pressure 

p 

473.223 

lb/ft2 

Water  surface  elevation 

u 

2.803 

ft 
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Plot  Output  File  1 

Table  2-3-1  below  is  a  partial  listing  of  plot  output  file  1  generated  (if  requested) 
by  this  application  for  the  example  problem. 

■:’y  Table  2-3-1 

Partial  Listing  of  Plot  Output  File  1 

Section  1  of  the  plot  output  file  1 


Kinematics  at  Z  (across  2  wavelengths) 


X/L 

ETA  U(x/L,z)  W(x/L,z) 

PRESSURE 

ax(x/L,z) 

az(x/L,z) 

(ft) 

(ft/s)  • 

(ft/s) 

(lb/ft2) 

:  (ft/S2) 

(ft/s2) 

T 

-i.boo 

,2.803 

3.150 

0.000 

473.223 

0.000 

- 

1.302 

2 

-0.992 

2.795 

3.143  . 

0.107 

472.899 

0.177 

1.297 

3 

-0.984 . 

2.773 

3.122 

0.213 

471.927 

0.352 

- 

1.280 

/O  4. 

-0.976 

2.737 

3.087  , 

0.317 

470.318 

0.525 

1.252 

"■  ■  :  5  \ 

-0.968 

2.686 

-3.039 

0.419 

468.082 

0.693 

- 

1.215 

,  6  ; 

-0.960 

2.623 

2.978 

0.5 17- 

465.238 

0.856 

1.167 

7 

-0.952 

2.547 

2.904 

0.612 

461.808 

.  1.012 

- 

1.110 

8 

0.944 

2.460 

2.819 

0.701 

457.820 

^  1.160 

- 

1.044 

9 

-0.936 

2.362 

2.722 

0.786; 

"•  453.303 

‘1.300 

-0.971 

10 

-0.928 

2.255 

2.615 

•  0.865 

448.294 

1.429 

/  -' 

0.892 

1 

''  A 

•  '  1  / 

1  ^  i 

t 

1 

n 

241  : 

0.920 

2.140 

2.499 

-0.937 

442.830 

-1.548 

-J 

0.807 

242 

0.928 

2.255 

2.615 

-0.865 

^  448.295 

-1.429 

-0.892 

243 

0.936 

2.362 

2.72.2 

-0.786 

453.305 

-1.300 

: 

0.971 

244 

0.944 

2.460 

2.819 

-0.701 

457-82 1 

-1.160 

■  - 

1 .044 

245 

0.952 

2.547 

2.904 

-0.612 

461.810 

-1.012 

V- 

1.110 

246 

0.960 

2.623 

2.978 

-0.517 

465.239 

-0.856 

1.167 

247 

0.968 

2.686 

3.039 

-0.419 

468.083 

■  -0.693 

1.215 

248- 

0.976 

2.737 

3.088 

-0.317 

470.318 

-0.525 

1.252 

249 

0.984 

2.773 

3.122 

-0.213 

471.928 

-0.352 

.  '  - 

1.280 

250 

0.992 

2.795 

;3.143 

-0.107 

472.899, 

-0.177 

•  I 

1.297 

251 

1.000 

2.803 

3.150 

0.000 

473.223 

0.000 

1,302 

(Table  2-3-1  Continued  on  the  Next  Page) 
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Section  2  of  the  plot  output  file  1 


Kinematics  Under  Wave  Crest 


Z 

ETA 

U(x/L,z) 

PRESSURE 

az(x/L,z) 

(ft) 

(ft) 

(ft/s) 

(lb/ft2) 

(ft/s2) 

1 

-22.000 

2.803 

2.682 

1539.861 

0.000 

2 

-21.901 

2.803 

2.682 

1533.514 

-0.007 

3 

-21.802 

2.803 

2.682 

1527.168 

-0.014 

4 

-21.702 

2.803 

2.682 

1520.823 

-0.021 

5 

-21.603 

2.803 

2.683 

1514.480 

-0.028 

6 

-21.504 

2.803 

2.683 

1508.138 

-0.035 

7 

-21.405 

2.803 

2.683 

1501.797 

-0.042 

8 

-21.306 

2.803 

2.683 

1495.458 

-0.049 

9 

-21.206 

2.803 

2.683 

1489.120 

-0.056 

10 

-21.107 

2.803 

2.684 

1482.784 

-0.063 

4 

4 

4 

4 

4 

4 

243 

2.009 

2.803 

3.667 

47.563 

-1.995 

244 

2.108 

2.803 

3.676 

41.609 

-2.006 

245 

2.207 

2.803 

3.685 

35.658 

-2.017 

246 

2.307 

2.803 

3.694 

29.709 

-2.028 

247 

2.406 

2.803 

3.703 

23.762 

-2.039 

248 

2.505 

2.803 

3.712 

17.818 

-2.050 

249 

2.604 

2.803 

3.722 

11.875 

-2.061 

250 

2.703 

2.803 

3.731 

5.935 

-2.072 

251 

2.803 

2.803 

3.740 

-0.003 

-2.083 

Screen  Plots 

This  application  generates  nine  screen  plots.  Figures  2-3-2  through  2-3-10  are 
plots  of  the  horizontal  and  vertical  velocity  and  acceleration,  pressure,  and  water 
surface  elevation  at  Z  as  a  function  of  the  horizontal  coordinate  (X/L).  Also 
plotted  is  the  horizontal  velocity,  vertical  acceleration,  and  pressure  under  the 
wave  crest. 


2-3-10 


Fourier  Series  Wave  Theory 


Wave' Theory 


ACES  User's  Guide 
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Figure  2-3-8.  Horizontal  Water  Velocity  Under  Wave  Crest 
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Figure  2-3-9.  Vertical  Acceleration  Under  Wave  Crest 
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Figure  2-3-10.  Pressure  Under  Wave  Crest 
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Linear  Wave  Theory  with  Snell's  Law 


Description 

This  application  provides  a  simple  estimate  for  wave  shoaling  and  refraction 
using  Snell’s  law  with  wave  properties  predicted  by  linear  wave  theory.  Given 
wave  properties  and  a  crest  angle  at  a  known  depth,  it  predicts  the  values  in 
deep  water  and  at  a  subject  location  specified  by  a  new  water  depth.  An  important 
assumption  for  this  application  is  that  all  depth  contours  are  assumed  to  be 
straight  and  parallel.  The  criteria  of  Singamsetti  and  Wind  (1980)  and  Weggel 
(1972)  are  employed  to  provide  an  estimate  for  breaker  parameters. 

Input 

The  coordinate  system  and  terminology  used  to  define  wave  motion  and  Snell’s 
law  are  shown  in  Figures  3-1-1  and  3-1-2. 


Wave  Orthogonals 


Figure  3-l**2.  Progressive  Wave  on  a  Nearshore  Slope 
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All  data  input  for  this  application  is  done  on  one  screen.  The  following  list 
describes  the  necessary  input  parameters  with  their  corresponding  units  and  range 
of  data  recognized  by  this  application: 


Location 

Item 

Svmbol 

Units 

Data  Ranee 

Known 

Wave  height 

ffi 

ft,  m 

0.1 

to 

200.0 

Wave  period 

T 

sec 

1.0 

to 

1000.0 

Water  depth 

di 

ft,  m 

0.1 

to 

5000.0 

Wave  crest  angle 

ai 

deg 

0.0 

to 

90.0 

Cotan  of  nearshore 

cot<j> 

5.0 

to 

1000.0 

slope 

Subject 

Water  depth 

di 

ft,  m 

0.1 

to 

5000.0 

Output 

Results  from  this  application  are  displayed  on  one  screen.  Those  data  include 
the  original  input  values  (in  final  units)  and  the  following  parameters: 


Wave  Location 


Item  i 

Known 

Deeo  Subiect  English 

Metric 

Water 

Units 

Units 

Wave  height 

Hi 

H0  H2 

ft 

m 

Wave  crest  angle 

«i 

«0  a2 

deg 

deg 

Wavelength 

Lx 

Lq  L  2 

ft 

m 

Wave  celerity 

ci 

c0  c2 

ft/sec 

m/sec 

Group  velocity 

Cgi 

CgQ  Cg2 

ft/sec 

m/sec 

Energy  density 

Ex 

Pq  P-2 

ft-lb/ft2 

N-m/m2 

Energy  flux 

Pi 

P0  P2 

ft-lb/sec-ft 

N-m/sec-m 

Deepwater  wave 

Hq/Lo 

steepness 

tf.i? 

HZL\ 

Ursell  number 

i  d? 

d\ 

Breaker  parameters 

Item 

Svmbol 

English 

Metric 

Units 

Units 

Height 

Hh 

ft 

m 

Depth 

dh 

ft 

m 
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Procedure 


The  bulleted  items  in  the  following  lists  indicate  potentially  optional  instruction 
steps.  Any  application  in  ACES  may  be  executed  in  a  given  session  without 
quitting  the  program.  The  bulleted  items  provide  instructions  for  accessing  the 
application  from  various  menu  areas  of  the  ACES  program.  Ignore  bulleted 
instruction  steps  that  are  not  applicable. 


Single  Case  Mode 

0  Press  (fi)  on  the  Main  Menu  to  select  Single  Case  Mode. 

°  Fill  in  the  highlighted  input  fields  on  the  General  Specifications  screen 
(or  leave  the  default  values).  Press  (fi)  when  all  data  on  this  screen 
are  correct. 

°  Press  (F3)  on  the  Functional  Area  Menu  to  select  Wave  Transformation. 

°  Press  (fT|  on  the  Wave  Transformation  Application  Menu  to  select 
Linear  Wave  Theory  with  Snell’s  Law. 

1.  Fill  in  the  highlighted  input  fields  on  the  Linear  Wave  Theory  with  Snell’s 
Law  screen.  Respond  to  any  corrective  instructions  appearing  at  the  bottom 
of  the  screen.  Press  @  when  all  data  on  this  screen  are  correct. 

2.  All  input  and  output  data  are  displayed  on  the  screen  in  the  final  system  of 
units. 

3.  Press  one  of  the  following  keys  to  select  the  appropriate  action: 

(fT)  Return  to  Step  1  for  a  new  case. 

(F3)  Send  a  summary  of  this  case  to  the  print  file  or  device. 

[fio]  Exit  this  application  and  return  to  the  Wave  Transformation 
Application  Menu. 


Multiple  Case  Mode 

°  Press  (F2)  on  the  Main  Menu  to  select  Multi  Case  Mode. 

°  Fill  in  the  highlighted  input  fields  on  the  General  Specifications  screen 
(or  leave  the  default  values).  Press  (fT)  when  all  data  on  this  screen 
are  correct. 

°  Press  (F3)  on  the  Functional  Area  Menu  to  select  Wave  Transformation. 

*  Press  (Fi)  on  the  Wave  Transformation  Application  Menu  to  select 
Linear  Wave  Theory  with  Snell’s  Law. 
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1.  Move  the  cursor  to  select  a  variable  on  the  Linear  Wave  Theory  with  Snell’s 
Law  screen  (the  selected  variable  name  blinks).  The  current  set  of  values 
for  the  variable  is  displayed  on  the  right  portion  of  the  screen.  When  all 
variable  sets  are  correct,  go  to  Step  3. 

2.  Enter  a  set  of  values  for  the  subject  variable  by  following  one  of  the  input 
methods: 

/ 

a.  Press  ®  to  select  random  method.  Enter  up  to  20  values  constituting 
a  set  for  this  variable  (one  in  each  field)  on  the  right  side  of  the  screen. 
The  set  of  20  values  originally  displayed  (first  execution)  in  these  fields 
contains  the  "delimiting"  value,  which  "delimits"  or  "ends"  the  set.  The 
"delimiting"  value  is  not  included  as  a  member  in  the  set  unless  it  is 
the  sole  member. 

b.  Press  (T)  to  select  incremental  method.  Fill  in  the  fields  for  minimum, 
maximum,  and  increment  values  for  this  variable  on  the  right  side  of 
the  screen.  In  this  method,  the  members  of  the  set  include  all  values 
from  the  minimum  to  the  maximum  (both  inclusive)  at  the  specified 
increment. 

The  units  field  should  also  be  specified  for  the  variable  regardless  of  input 
method.  All  members  of  a  set  of  values  for  a  subject  variable  are  assigned 
the  specified  units.  When  all  data  are  correct  for  the  subject  variable,  press 
(fio]  to  return  to  Step  I.  Errors  are  reported  at  the  bottom  of  the  screen 
and  are  corrected  by  pressing  (fi)  to  allow  respecification  of  the  data  for  the 
subject  variable. 

3.  Press  (Fl)  to  process  the  cases  resulting  from  the  combinations  of  the  sets  of 
data  for  all  variables.  The  summary  of  each  case  will  be  sent  to  the  print 
file  or  device.  The  screen  will  display  the  total  number  of  cases  to  be 
processed  as  well  as  report  progress.  Errors  are  reported  at  the  bottom  of 
the  screen  and  are  corrected  by  pressing  (fT)  to  allow  respecification  of 
variable  sets. 

4.  Press  one  of  the  following  keys  to  select  the  appropriate  action: 


[fi)  Return  to  Step  1  to  specify  new  sets. 

]Fio)  Exit  this  application  and  return  to  the  Wave  Transformation 
Application  Menu. 
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Input 


All  data  input  for  this  application  is  done  on  one  screen.  The  values  and 
corresponding  units  selected  for  this  example  problem  are  shown  below. 


Location 

Item 

Symbol 

Value 

Units 

Known 

Wave  height 

Hi 

10.00 

ft 

Wave  period 

T 

7.50 

sec 

Water  depth 

di 

25.00 

ft 

Wave  crest  angle 

Cotan  of  nearshore 
slope 

cot<|> 

10.00 

100.00 

deg 

Subject 

Water  depth 

^2 

20.00 

ft 

Output 

Results  from  this  application  are  displayed  on  one  screen.  Those  data  include 
the  original  input  values  and  the  following  parameters  (see  Figure  3-1-3  for 
location  of  calculated  parameters): 


Wave  Location 

Item 

Known 

DeeD 

Water 

Subiect 

Units 

Wave  height 

10.00 

10.68 

10.27 

ft 

Wave  crest  angle 

10.00 

15.00 

9.12 

deg 

Wavelength 

193.27 

288.00 

176.34 

ft 

Wave  celerity 

25.77 

38.40 

23.51 

ft/sec 

Group  velocity 

21.46 

19.20 

20.31 

ft/sec 

Energy  density 

799.83 

911.50 

843.04 

ft- lb/ft2 

Energy  flux 

17165.59 

17500.84 

17121.06 

ft-lb/sec-ft 

Ursell  number 

Deepwater  wave 

23.91 

0.04 

39.91 

steepness 
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Breaker  parameters 

Item 

Svmbol 

Value 

Units 

Height 

ffb 

12.29 

ft 

Depth 

db 

15.25 

ft 
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Irregular  Wave  Transformation  (Goda's  method) 


Description 

This  application  yields  cumulative  probability  distributions  of  wave  heights  as 
a  field  of  irregular  waves  propagate  from  deep  water  through  the  surf  zone.  The 
application  is  based  on  two  random-wave  theories  by  Yoshimi  Goda  (1975  and 
1984).  The  1975  paper  concerns  transformation  of  random  waves  shoaling  over 
a  plane  bottom  with  straight  parallel  contours.  This  analysis  treated  breaking 
and  broken  waves  and  resulted  in  cumulative  probability  distributions  for  wave 
heights  given  a  water  depth.  It  did  not  include  refraction,  however.  The  1984 
book  details  a  refraction  procedure  for  random  waves  propagating  over  a  plane 
bottom  with  straight  parallel  contours  assuming  a  particular  incident  spectrum. 
This  ACES  application  combines  the  two  approaches  by  treating  directional 
random  waves  propagating  over  a  plane  bottom  with  straight  parallel  contours. 
This  application  also  uses  the  theory  of  Shuto  (1974)  for  the  shoaling  calculation. 
The  theories  assume  a  Rayleigh  distribution  of  wave  heights  in  the  nearshore 
zone  and  a  Bretschneider-Mitsuyasu  incident  directional  spectrum. 


Input 


All  data  input  for  this  application  is  done  on  one  screen.  The  following  list 
describes  the  necessary  input  parameters  with  their  corresponding  units  and  range 
of  data  recognized  by  this  application: 


Item 

Symbol 

Units 

Data  Range 

Significant  deepwater  wave 

H0 

ft 

2.00 

to 

20.0 

height 

m 

0.61 

to 

6.09 

Water  depth 

d 

ft,  m 

10.00 

to 

5000.0 

Significant  wave  period 

T 

sec 

4.00 

to 

16.0 

Cotan  of  nearshore  slope 

cot<|> 

30.00 

to 

100.0 

Principal  direction  of  incident 
wave  spectrum 

9 

deg 

-75.00 

to 

75.0 
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Output 

Results  from  this  application  are  displayed  on  one  screen.  In  addition,  there  is 
an  option  (available  in  the  Single  Case  Mode  only)  to  send  data  to  plot  output 
file  1  (default  name  PLOTDATl.OUT).  This  application  also  generates  two 
screen  plots.  Each  of  these  outputs  is  described  below. 


Screen  Output 

Results  from  this  application  are  displayed  on  one  screen.  Those  data  include 
the  original  input  values  (in  final  units)  and  the  following  parameters: 


Item 

Svmbol 

English 

Units 

Metric 

Units 

Significant  wave  height 

ft 

m 

Mean  wave  height 

H 

ft 

m 

Root-mean-square  wave  height 

LT 

iirms 

ft 

m 

Average  of  highest  10  percent 
of  all  waves 

ffio 

ft 

m 

Average  of  highest  2  percent  of 
all  waves 

#2 

ft 

m 

Maximum  wave  height 

ZJ 

■“max 

ft 

m 

Shoaling  coefficient 

Root-mean-square  surf  beat 

K 

ft 

m 

Wave  setup 

Sy, 

ft 

m 

Deepwater  wave  steepness 

H0/L0 

Effective  refraction  coefficient 

Kt 

Ratio  of  water  depth  to 
deepwater  wave  height 

d/H0 

Relative  water  depth 

d/L0 

Plot  Output  File  1 

Plot  output  file  1  contains  wave  heights  with  their  cumulative  probability 
distribution  of  exceedance  for  both  deep  water  and  the  specified  depth  and  is 
available  in  Single  Case  Mode  only.  The  data  are  written  to  plot  output  file  1 
in  the  following  format  (refer  to  the  Example  Problem  section  for  a  paradigm): 
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Field 

Columns 

Format 

Data 

1 

1-10 

F10.3 

Wave  height  in  deep  water 

2 

11-20 

F10.3 

Cumulative  probability  distribution  of 
exceedance  (CDF) 

3 

21-30 

F10.3 

Wave  height  in  water  depth  of  interest 

4 

31-40 

F10.3 

Cumulative  probability  distribution  of 
exceedance  (CDF2) 

Screen  Plots 

This  application  generates  two  plots.  These  plots  may  be  accessed  by  selecting 
the  Plot  Data  option  (fF2))  from  the  Options  menu  on  the  data  output  screen. 
The  plots  generated  are  shown  in  Figures  3-2-1  and  3-2-2  in  the  example  problem 
below.  The  first  plot  displayed  is  the  cumulative  probability  distribution  of 
exceedance  (CDF)  versus  wave  height  in  deep  water.  The  second  plot  is  the 
CDF  versus  wave  height  in  water  depth  of  interest. 


Procedure 


The  bulleted  items  in  the  following  lists  indicate  potentially  optional  instruction 
steps.  Any  application  in  ACES  may  be  executed  in  a  given  session  without 
quitting  the  program.  The  bulleted  items  provide  instructions  for  accessing  the 
application  from  various  menu  areas  of  the  ACES  program.  Ignore  bulleted 
instruction  steps  that  are  not  applicable. 

Single  Case  Mode 

“  Press  (fi)  on  the  Main  Menu  to  select  Single  Case  Mode. 

°  Fill  in  the  highlighted  input  fields  on  the  General  Specifications  screen 
(or  leave  the  default  values).  Press  (fi)  when  all  data  on  this  screen 
are  correct. 

0  Press  (f3)  on  the  Functional  Area  Menu  to  select  Wave  Transformation. 

°  Press  fF2)  on  the  Wave  Transformation  Application  Menu  to  select 
Goda’s  Wave  Transformation. 

1 .  Fill  in  the  highlighted  input  fields  on  the  Goda's  Wave  Transformation  screen. 
Respond  to  any  corrective  instructions  appearing  at  the  bottom  of  the  screen. 
Press  (fT)  when  all  data  on  this  screen  are  correct. 

2.  All  input  and  output  data  are  displayed  on  the  screen  in  the  final  system  of 
units. 

3.  Press  one  of  the  following  keys  to  select  the  appropriate  action: 
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(fi)  Return  to  Step  1  for  a  new  case. 

(F2)  Plot  the  data. 

(F3)  Send  a  summary  of  this  case  to  the  print  file  or  device. 

[F4]  Generate  a  file  containing  plot  data  (cumulative  probability 
versus  wave  height). 

[fio]  Exit  this  application  and  return  to  the  Wave  Transformation 
Application  Menu. 

Multiple  Case  Mode 

°  Press  [F2)  on  the  Main  Menu  to  select  Multi  Case  Mode. 

°  Fill  in  the  highlighted  input  fields  on  the  General  Specifications  screen 
(or  leave  the  default  values).  Press  (fi)  when  all  data  on  this  screen 
are  correct. 

0  Press  [F3]  on  the  Functional  Area  Menu  to  select  Wave  Transformation. 

0  Press  (F2)  on  the  Wave  Transformation  Application  Menu  to  select 
Goda’s  Wave  Transformation. 

1.  Move  the  cursor  to  select  a  variable  on  the  Goda’s  Wave  Transformation 
screen  (the  selected  variable  name  blinks).  The  current  set  of  values  for  the 
variable  is  displayed  on  the  right  portion  of  the  screen.  When  all  variable 
sets  are  correct,  go  to  Step  3. 

2.  Enter  a  set  of  values  for  the  subject  variable  by  following  one  of  the  input 
methods: 

a.  Press  ®  to  select  random  method.  Enter  up  to  20  values  constituting 
a  set  for  this  variable  (one  in  each  field)  on  the  right  side  of  the  screen. 
The  set  of  20  values  originally  displayed  (first  execution)  in  these  fields 
contains  the  "delimiting"  value,  which  "delimits"  or  "ends"  the  set.  The 
"delimiting"  value  is  not  included  as  a  member  in  the  set  unless  it  is 
the  sole  member. 

b.  Press  (T)  to  select  incremental  method.  Fill  in  the  fields  for  minimum, 
maximum,  and  increment  values  for  this  variable  on  the  right  side  of 
the  screen.  In  this  method,  the  members  of  the  set  include  all  values 
from  the  minimum  to  the  maximum  (both  inclusive)  at  the  specified 
increment. 

The  units  field  should  also  be  specified  for  the  variable  regardless  of  input 
method.  All  members  of  a  set  of  values  for  a  subject  variable  are  assigned 
the  specified  units.  When  all  data  are  correct  for  the  subject  variable,  press 
(fio)  to  return  to  Step  1.  Errors  are  reported  at  the  bottom  of  the  screen 
and  are  corrected  by  pressing  (®)  to  allow  respecification  of  the  data  for  the 
subject  variable. 
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3.  Press  (fT)  to  process  the  cases  resulting  from  the  combinations  of  the  sets  of 
data  for  all  variables.  The  summary  of  each  case  will  be  sent  to  the  print 
file  or  device.  The  screen  will  display  the  total  number  of  cases  to  be 
processed  as  well  as  report  progress.  Errors  are  reported  at  the  bottom  of 
the  screen  and  are  corrected  by  pressing  (fT|  to  allow  respecification  of 
variable  sets. 

4.  Press  one  of  the  following  keys  to  select  the  appropriate  action: 

(fT)  Return  to  Step  1  to  specify  new  sets. 

[Fio]  Exit  this  application  and  return  to  the  Wave  Transformation 
Application  Menu. 

NOTE:  Multiple  Case  Mode  does  not  generate  any  plot  output 
files  or  plots. 


Example  Problem 


Input 

All  data  input  for  this  application  is  done  on  one  screen.  The  values  and 


corresponding  units  selected  for  this  example  problem  are  shown  below. 

Item 

Symbol 

Value 

Units 

Significant  deepwater 
wave  height 

H o 

20.00 

ft 

Water  depth 

d 

50.00 

ft 

Significant  wave  period 

T 

1  B 

8.00 

sec 

Cotan  of  nearshore  slope 

cot<t> 

100.00 

Principal  direction  of  incident 
wave  spectrum 

© 

10.00 

deg 

Output 

Results  from  this  application  are  displayed  on  one  screen  and,  if  requested, 
written  to  plot  output  file  1  (default  name  PLOTDATl.OUT).  In  addition,  two 
plots  are  generated.  Each  of  these  outputs  for  the  example  problem  is  presented 
below. 
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Screen  Output 

Results  from  this  application  are  displayed  on  one  screen.  Those  data  include 
the  original  input  values  and  the  following  parameters: 


Item 

Svmbol 

Subject 

Deep  Water 

Units 

Significant  wave  height 

He 

17.7 

20.1 

ft 

Mean  wave  height 

H 

11.2 

12.5 

ft 

Root-mean-square  wave 
height 

■^rms 

12.5 

14.1 

ft 

Average  of  highest  10  percent 
of  all  waves 

Hw 

22.5 

27.0 

ft 

Average  of  highest  2  percent 
of  all  waves 

26.7 

32.1 

ft 

Maximum  wave  height 

[J 

"max 

30.1 

37.6 

ft 

Shoaling  coefficient 

*s 

0.9133 

1.0000 

Root-mean-square  surf  beat 

0.4350 

0.1766 

ft 

Wave  setup 

Sw 

-0.0763 

-0.0218 

ft 

Deepwater  wave  steepness 

HJLa 

0.0611 

0.0611 

Effective  refraction- 
coefficient 

Kr 

0.9638 

Ratio  of  water  depth  to 
deepwater  wave  height 

d/H0 

2.4655 

20.0000 

Relative  water  depth 

d/L0 

0.1505 

1.2212 
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Plot  Output  File  1 

Table  3-2-1  below  is  a  partial  listing  of  plot  output  file  1  generated  by  this 
application. 


Table  3-2-1 

Wave  Height  versus  Cumulative  Probability 
Distribution  of  Exceedance 


Deep  Water  Water  Depth  =  50  ft 


H  (ft) 

CDF 

H  (ft) 

CDF2 

0.328 

0.001 

0.328 

0.001 

0.656 

0.004 

0.656 

0.003 

0.984 

0.007 

0.984 

0.007 

1.312 

0.011 

1.312 

0.012 

1.640 

0.017 

1.640 

0.018 

1.968 

0.023 

1.968 

0.026 

2.296 

0.030 

2.296 

0.034 

2.624 

0.039 

2.624 

0.044 

2.952 

0.048 

2.952 

0.055 

3.280 

0.058 

3.280 

0.067 

4 

4 

4 

4 

26.240 

0.970 

26.240 

0.995 

26.568 

0.972 

26.568 

0.996 

26.896 

0.975 

26.896 

0.997 

27.224 

0.977 

27.224 

0.998 

27.552 

0.979 

27.552 

0.998 

27.880 

0.981 

27.880 

0.999 

28.208 

0.982 

28.536 

0.984 

28.864 

0.985 

29.192 

0.987 

4 

4 

33.784 

0.997 

34.112 

0.997 

34.440 

0.998 

34.768 

0.998 

35.096 

0.998 

35.424 

0.998 

35.752 

0.998 

36.080 

0.999 

36.408 

0.999 

36.736 

0.999 
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Screen  Plots 

This  application  generates  two  plots.  These  plots  may  be  accessed  by  selecting 
the  Plot  Data  option  (fF2))  from  the  Options  menu  on  the  data  output  screen. 
The  plots  generated  for  the  example  problem  are  shown  in  Figures  3-2-1  and 
3-2-2  below.  The  first  plot  displayed  is  the  cumulative  probability  distribution 
of  exceedance  (CDF)  versus  wave  height  in  deep  water.  The  second  plot  is  the 
CDF  versus  wave  height  in  water  depth  of  interest.  After  viewing  the  first  plot, 
the  second  plot  may  be  displayed  by  selecting  the  NEXT  option  in  the  graphics 
package  (see  Appendix  C). 


Figure  3-2-1.  Wave  Height  versus  Cumulative  Probability  Distribution  of  Exceedance 

(Deep  Water) 


Figure  3-2-2.  Wave  Height  versus  Cumulative  Probability  Distribution  of  Exceedance 

(Water  Depth  =  50  ft) 
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Combined  Diffraction  and  Reflection  by  a  Vertical 
Wedge 


Description 


This  application  estimates  wave  height  modification  due  to  combined  diffraction 
and  reflection  near  jettied  harbor  entrances,  quay  walls,  and  other  such  structures. 
Jetties  and  breakwaters  are  approximated  as  a  single  straight,  semi-infinite 
breakwater  by  setting  the  wedge  angle  to  zero.  Corners  of  docks  and  quay  walls 
may  be  represented  by  setting  the  wedge  angle  equal  to  90  deg.  Additionally, 
such  natural  diffracting  and  reflecting  obstacles  as  rocky  headlands  can  be 
approximated  by  setting  a  particular  value  for  the  wedge  angle.  Assumptions 
include  monochromatic,  linear  waves,  and  constant  water  depth. 


Coordinate  System 

The  coordinate  system  and  terminology  used  in  the  diffraction  and  reflection  by 
a  vertical  wedge  is  shown  in  Figure  3-3-1. 


Incident  Wave  Ray 


Figure  3-3-1.  Diffraction/Reflection  by  Vertical  Wedge  System 
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Procedure 


This  section  provides  instructions  for  running  this  application  in  the  Single  Case 
and  Multiple  Case  modes. 


Single  Case  Mode 

°  Press  (fT)  on  the  Main  Menu  to  select  Single  Case  Mode. 

°  Fill  in  the  highlighted  input  fields  on  the  General  Specifications  screen 
(or  leave  the  default  values).  Press  (fT)  when  all  data  on  this  screen 
are  correct. 

°  .  Press  (F3)  on  the  Functional  Area  Menu  to  select  Wave  Transformation. 

°  Press  (F3)  on  the  Wave  Transformation  Application  Area  Menu  to  select 
Combined  Diffraction  and  Reflection  by  a  Vertical  Wedge. 


In  Single  Case  mode,  this  application  allows  two  options  for  calculating  a 
modification  factor  and  modified  wave  height. 

°  At  a  single  location. 

°  Upon  a  uniform  grid. 

From  the  Activity  Menu,  select  either  the  Single  Location  or  .  Uniform  Grid 
option.  These  two  options  are  described  below. 


(fi)  Evaluate  at  a  Single  Location 

All  data  input  for  this  option  is  done  on  one  screen.  The  following  list  describes 
the  necessary  input  parameters  with  their  corresponding  units  and  range  of  data 


recognized  by  this  application: 

Item  Symbol 

Incident  Wave  Height  H , 

Wave  Period  T 


Units  Data  Range 

ft,m  0.1  to  200 

sec  1  to  1000 
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Water  Depth 

d 

ft,m 

0.01 

to 

5000 

Wave  Angle 

a 

deg 

0 

to 

180 

Wedge  Angle 

deg 

0 

to 

180 

X  Coordinate 

X 

ft,m 

-5280 

to 

5280 

Y  Coordinate 

y 

ft,m 

-5280 

to 

5280 

NOTE:  In  practice,  the  range  for  X  and  Y  should  be  limited  to 
plus  or  minus  10  wavelengths. 


When  all  the  data  have  been  entered  press,  ED  to  begin  calculations.  When 
calculations  have  been  completed,  all  input  and  output  data  are  displayed  on  the 
screen  in  the  selected  system  of  units.  Output  data  include  the  following 
parameters: 


Item 

Svmbol 

English 

Units 

Metric 

Units 

Wave  Length 

L 

ft 

m 

Modification  Factor  (ratio  of 
calculated  wave  height  to 
incident  wave  height) 

Wave  Phase 

P 

rad 

rad 

Modified  Wave  Height 

H 

ft 

m 

After  data  have  been  displayed,  press  one  of  the  following  keys  to  select  the 
appropriate  action: 


[ft]  Return  to  Step  1  for  a  new  case. 

(F3]  Send  a  summary  of  this  case  to  the  print  file  or  device. 
(fio)  Exit  this  application  and  return  to  the  Activity  Menu. 
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[F2)  Evaluate  Upon  a  Uniform  Grid 

All  data  input  for  this  option  is  done  on  one  screen.  The  following  list  describes 
the  necessary  input  parameters  with  their  corresponding  units  and  range  of  data 
recognized  by  this  application: 


Item 

Symbol 

Units 

Data  Ranee 

Incident  Wave  Height 

Hi 

ft,m 

0.1 

to 

200 

Wave  Period 

T 

sec 

1 

to 

1000 

Water  Depth 

d 

ft,m 

0.01 

to 

5000 

Wave  Angle 

a 

deg 

0 

to 

180 

Wedge  Angle 

deg 

0 

to 

180 

X  Start  Coordinate 

*0 

ft,m 

-5280 

to 

5280 

X  End  Coordinate 

xm 

ft,m 

-5280 

to 

5280 

Spatial  Increment  (X-direction) 

AX 

0.1 

to 

5280 

Y  Start  Coordinate 

y  o 

ft,m 

-5280 

to 

5280 

Y  End  Coordinate 

ft,m 

-5280 

to 

5280 

Spatial  Increment  (Y-direction) 

AY 

0.1 

to 

5280 

CAUTION:  For  the  application  to  function  properly,  the  Start 
Coordinate  for  both  the  X-  and  Y-directions  must  be  less  than 
the  corresponding  End  Coordinate. 


When  all  the  data  have  been  entered,  press  lED  to  begin  calculations.  When 
calculations  have  been  completed,  all  input  and  output  data  are  sent  to  the  print 
file  or  device  and  also  to  plot  output  file  1  (default  name  PLOTDATl.OUT). 
See  the  section  titled  Plot  Output  File  1  for  the  description  and  format  of  the 
contents  of  plot  output  file  1. 

After  calculations  have  been  completed,  press  one  of  the  following  keys  to  select 
the  appropriate  action: 

(ED  Return  to  Step  1  for  a  new  case. 

[fio]  Exit  this  application  and  return  to  the  Activity  Menu. 
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Plot  Output  File  1 

Plot  output  file  1  (default  name  PLOTDATl.OUT)  contains  the  Modification 
Factors,  Modified  Wave  Heights,  and  Wave  Phase  differences  between  the  incident 
and  the  modified  waves  at  the  grid  points  defined  by  the  X  and  Y  start  and  end 
coordinates.  Plot  output  file  1  is  written  in  the  following  format  (see  Table 
3-3-2  in  Example  Problem  3): 


Field 

Columns 

Format 

Data 

1 

1-10 

G10.3 

X-coordinate 

2 

11-20 

G10.3 

Y- coordinate 

3 

21-30 

G10.3 

Modified  wave  height 

4 

31-40 

G10.3 

Modification  factor 

5 

41-50 

G10.3 

Wave  phase  difference 

Multiple  Case  Mode 

0  Press  (f2)  on  the  Main  Menu  to  select  Multi  Case  Mode. 

0  Fill  in  the  highlighted  input  fields  on  the  General  Specifications  screen 
(or  leave  the  default  values).  Press  (Ft)  when  all  data  on  this  screen 
are  correct. 

°  Press  (F3)  on  the  Functional  Area  Menu  to  select  Wave  Transformation. 

°  Press  (F3)  on  the  Wave  Transformation  Application  Menu  to  select 
Combined  Diffraction  and  Reflection  by  a  Vertical  Wedge. 


1.  Move  the  cursor  to  select  a  variable  on  the  Combined  Diffraction  and 
Reflection  by  a  Vertical  Wedge  screen  (the  selected  variable  name  blinks). 
The  current  set  of  values  for  the  variable  is  displayed  on  the  right  portion 
of  the  screen.  When  all  variable  sets  are  correct,  go  to  Step  3. 

2.  Enter  a  set  of  values  for  the  subject  variable  by  following  one  of  the  input 
methods: 
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a.  Press  ®  to  select  random  method.  Enter  up  to  20  values  constituting 
a  set  for  this  variable  (one  in  each  field)  on  the  right  side  of  the  screen. 
The  set  of  20  values  originally  displayed  (first  execution)  in  these  fields 
contains  the  "delimiting"  value,  which  "delimits"  or  "ends"  the  set.  The 
"delimiting"  value  is  not  included  as  a  member  in  the  set  unless  it  is 
the  sole  member. 

b.  Press  CD  to  select  incremental  method.  Fill  in  the  fields  for  minimum, 
maximum,  and  increment  values  for  this  variable  on  the  right  side  of 
the  screen.  In  this  method,  the  members  of  the  set  include  all  values 
from  the  minimum  to  the  maximum  (both  inclusive)  at  the  specified 
increment. 

The  units  field  should  also  be  specified  for  the  variable  regardless  of  input 
method.  All  members  of  a  set  of  values  for  a  subject  variable  are  assigned 
the  specified  units.  When  all  data  are  correct  for  the  subject  variable,  press 
[ftp]  to  return  to  Step  1.  Errors  are  reported  at  the  bottom  of  the  screen 
and  are  corrected  by  pressing  (fT)  to  allow  respecification  of  the  data  for  the 
subject  variable. 


3.  Press  (fT)  to  process  the  cases  resulting  from  the  combinations  of  the  sets  of 
data  for  all  variables.  The  summary  of  each  case  will  be  sent  to  the  print 
file  or  device.  The  screen  will  display  the  total  number  of  cases  to  be 
processed  as  well  as  report  progress.  Errors  are  reported  at  the  bottom  of 
the  screen  and  are  corrected  by  pressing  (fT)  to  allow  respecification  of 
variable  sets. 

4.  Press  one  of  the  following  keys  to  select  the  appropriate  action: 

ED  Return  to  Step  I  to  specify  new  sets. 

[fio)  Exit  this  application  and  return  to  the  Wave  Transformation 
Application  Menu. 
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Example  Problems 

Example  1  -  Semi-Infinite  Breakwater  (Single  Point) 


Input 

All  data  input  for  this  application  is  done  on  one  screen.  The  values  and 
corresponding  units  selected  for  this  first  example  problem  are  shown  below. 


item 

Symbol 

Value 

Units 

Incident  Wave  Height 

2.0 

ft 

Wave  Period 

T 

6.0 

sec 

Water  Depth 

d 

12.0 

ft 

Wave  Angle 

a 

135.0 

deg 

Wedge  Angle 

0.0 

deg 

X  Coordinate 

X 

35.0 

ft 

Y  Coordinate 

Y 

-17.0 

ft 

Output 

Results  from  this  application  are  displayed  on  one 

screen.  These  data  include 

the  original  input  values  and  the  following  parameters  (see  Figure 

3-3-2); 

Item 

Svmbol 

Value 

Units 

Wave  Length 

L 

109.82 

ft 

Modification  Factor  (ratio  of 

4> 

0.58 

calculated  wave  height  to 
incident  wave  height) 

Wave  Phase 

P 

-2.58 

rad 

Modified  Wave  Height 

H 

1.16 

ft 

Incident  Wave 


Location  of  desired  calculation 
*  (35.- 17) 

Figure  3-3-2.  Semi-Infinite  Breakwater  Diffraction/Reflection  Example  Output 


Combined  Diffraction  and  Reflection  by  a  Vertical  Wedge 


3-3-7 


ACES  User  Guide 


Wave  Transformation 


Example  2  -  90-Deg  Wedge  (Single  Point) 


Input 

All  data  input  for  this  application  is  done  on  one  screen.  The  values  and 
corresponding  units  selected  for  this  second  example  problem  are  shown  below. 


Item 

Symbol 

Value 

Units 

Incident  Wave  Height 

Hi 

5 

m 

Wave  Period 

T 

8 

sec 

Water  Depth 

d 

10 

m 

Wave  Angle 

a 

47 

deg 

Wedge  Angle 

90 

deg 

X  Coordinate 

X 

-10 

m 

Y  Coordinate 

Y 

-40 

m 

Output 

Results  from  this  application  are  displayed  on  one 

screen.  These  data  include 

the  original  input  values  and  the  following  parameters  (see  Figure  3-3-3): 

Item 

Svmbol 

Value 

Units 

Wave  Length 

L 

70.88 

m 

Modification  Factor  (ratio  of 

<t> 

0.60 

calculated  wave  height  to 

incident  wave  height) 

Wave  Phase 

P 

2.12 

rad 

Modified  Wave  Height 

H 

3.01 

m 

Y 

Incident  Wove 

Figure  3-3-3.  90-Deg  Wedge  Diffraetion/Rcflection  Example  Output 
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Example  3  -  Semi-Infinite  Breakwater  (Uniform  Grid) 

Input 

All  data  input  for  this  application  is  done  on  one  screen.  The  values  and 
corresponding  units  selected  for  this  second  example  problem  are  shown  below 
(see  Figure  3-3-4). 


Item 

Svmbol 

Value 

Units 

Incident  Wave  Height 

H, 

4 

ft 

Wave  Period 

T 

12 

sec 

Water  Depth 

d 

30 

ft 

Wave  Angle 

a 

52 

deg 

Wedge  Angle 

0 

deg 

X  Start  Coordinate 

X0 

-600 

ft 

X  End  Coordinate 

200 

ft 

Spatial  Increment  (X-direction) 

AX 

200 

ft 

Y  Start  Coordinate 

X0 

-400 

ft 

Y  End  Coordinate 

xm 

200 

ft 

Spatial  Increment  (Y-direction) 

AY 

100 

ft 

Incident  Wave  Ray 


Figure  3-3-4.  Semi-Infinite  Breakwater  Diffraction /Reflection  (uniform  grid) 
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Output 

Results  from  this  application  are  sent  to  the  print  file  or  device  (see  Table  3-3-1) 
and  to  plot  output  file  1  (default  name  PLOTDATl.OUT)  (see  Table  3-3-2). 

Print  File  or  Device 


Table  3-3-1 

Combined  Reflection  and  Diffraction  by  a  Vertical  Wedge 


Incident  Wave  Height  — 

4.00  ft 

Wave  Period 

= 

12.00  sec 

Water  Depth 

= 

30.00  ft 

W  avelength 

= 

356.85  ft 

W  ave  Angle 

= 

52.00  deg 

Wedge  Angle 

— 

0.00  deg 

*  *  ** * 

Modification  Factors: 

x= 

:  -600.00 

-400.00 

-200.00 

0.00 

200.00 

y= 

200.00 

1.00 

1.15 

1.27 

1.67 

1.88 

y= 

100.00 

1.04 

1.00 

0.83 

0.74 

0.20 

y= 

0.00 

1.00 

1.00 

1.00 

1.00 

1.77 

y= 

-100.00 

1.04 

1.03 

0.86 

0.46 

0,23 

y= 

-200.00 

1.06 

0.93 

0.66 

0.37 

0.22 

y= 

-300.00 

1.00 

0.80 

0.53 

0.32 

0.21 

y= 

-400.00 

0.90 

0.67 

0.44 

0.28 

0.20 

X= 

-600.00 

-400.00 

-200.00 

0.00 

200.00 

*  *  *  *  * 

Modified  Wave  Heights  ( 

ft  ): 

x= 

-600.00 

-400.00 

-200.00 

0.00 

200.00 

y= 

200.00 

4702  " 

4.59 

5.07 

6.68 

7.52 

y= 

100.00 

4.17 

4.00 

3.33 

2.96 

0.81 

y= 

0.00 

4.00 

4.00 

4.00 

4.00 

7.08 

y= 

-100.00 

4.17 

4.10 

3.42 

1.84 

0.92 

y= 

-200.00 

4.25 

3.74 

2.66 

1.48 

0.88 

y= 

-300.00 

4.02 

3.19 

2.12 

1.27 

0.84 

y= 

-400.00 

3.61 

2.68 

1.77 

1.14 

0.80 

X= 

:  "-'60o7ott 

-40o7o0 '  " 

'  --'200700'  ' 

0.00 

500.7)0  "  ' 

***** 

Phase  Angles  (  rad  ): 

x= 

-600.00 

-400.00 

-200.00 

0.00 

200.00 

y- 

200.00 

2.47  " 

-1.60 

0.79 

-2.97 

-T709 

y= 

100.00 

1.18 

-2.87 

-0.75 

0.52 

2.77 

y= 

0.00 

-0.22 

1.95 

-2.17 

0.00 

2.18 

y= 

-100.00 

-1.61 

0.63 

2.82 

-2.22 

1.64 

y= 

-200.00 

-2.93 

-0.68 

1.34 

2.22 

0.60 

y~ 

-300.00 

2.04 

-2.07 

-0.27 

0.42 

-0.77 

y= 

-400.00 

0.69 

2.75 

-1.94 

-1.37 

-2.30 

X= 

-600T00  ‘ 

-400.00 

'  '  -'200700  '  '  " 

0.00 

200.00  "  ' 
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Plot  Output  File  1 

Plot  output  file  1  (default  name  PLOTDATl.OUT)  contains  at  grid  points  defined 
by  the  X  and  Y  start  and  end  coordinates  the  Modified  Wave  Heights,  Modification 
Factors,  and  Wave  Phase  differences  between  the  incident  and  modified  waves. 
Table  3-3-2  is  a  listing  of  plot  output  file  1  for  Example  3. 

Table  3-3-2 

Listing  of  Plot  Output  File  1  for  Example  Problem  3 


Combined  Reflection  and  Diffraction  by  a  Vertical  Wedge 
Wedge  Angle:  0  Incident  Wave  Angle:  52 


ft 

ft 

ft 

rad 

-600. 

-400. 

3.61 

0.903 

0.690 

-400. 

-400. 

2.68 

0.670 

2.75 

-200. 

-400. 

1.77 

0.442 

-1.94 

0.000 

-400. 

1.14 

0.285 

-1.37 

200. 

-400. 

0.804 

0.201 

-2.30 

-600. 

-300. 

4.02 

1.00 

2.04 

-400. 

-300. 

3.19 

0.798 

-2.07 

-200. 

-300. 

2.12 

0.531 

-0.273 

0.000 

-300. 

1.27 

0.319 

0.419 

200. 

-300. 

0.843 

0.211 

-0.772 

-600. 

-200. 

4.25 

1.06 

-2.93 

-400. 

-200. 

3.74 

0.934 

-0.684 

-200. 

-200. 

2.66 

0.665 

1.34 

0.000 

-200. 

1.48 

0.369 

2.22 

200. 

-200. 

0.882 

0.221 

0.599 

-600. 

-100. 

4.17 

1.04 

-1.61 

-400. 

-100. 

4.10 

1.03 

0.629 

-200. 

-100. 

3.42 

0.856 

2.82 

0.000 

-100. 

1.84 

0.460 

-2.22 

200. 

-100. 

0.916 

0.229 

1.64 

-600. 

0.000 

4.00 

1.00 

-0.221 

-400. 

0.000 

4.00 

1.00 

1.95 

-200. 

0.000 

4.00 

1.00 

-2.17 

0.000 

0.000 

4.00 

1.00- 

0.000 

200. 

0.000 

7.08 

1.77 

2.18 

-600. 

100. 

4.17 

1.04 

1.18 

-400. 

100. 

4.00 

1.00 

-2.87 

-200. 

100. 

3.33 

0.833 

-0.754 

(Table  3-3-2  Continued  on  the  Next  Page) 
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(Table  3-3-2  Concluded) 


0.000 

100. 

2.96 

0.740 

0.517 

200. 

100. 

0.809 

0.202 

2.77 

-600. 

200. 

4.02 

1.00 

2.47 

-400. 

200. 

4.59 

1.15 

-1.60 

-200. 

200. 

5.07 

1.27 

0.787 

0.000 

200. 

6.68 

1.67 

-2.97 

200. 

200. 

7.52 

1.88 

-1.09 
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Breakwater  Design  Using  Hudson  and  Related  Equations 


Description 

This  application  provides  estimates  for  the  armor  weight,  minimum  crest  width, 
armor  thickness,  and  the  number  of  armor  units  per  unit  area  of  a  breakwater 
using  Hudson  and  related  equations. 

Input 


All  data  input  for  this  application  is  done  on  one  screen.  The  following  list 
describes  the  necessary  input  parameters  with  their  corresponding  units  and  range 
of  data  recognized  by  this  application: 


Item 

Symbol 

Units 

Data  Range 

Armor  unit  weight 

wr 

lb/ft3,  N/m3 

1.0  to  99999.0 

Wave  height 

Hi 

ft,  m  * 

0.1  to  100.0 

Stability  coefficient 

Kt> 

See  Table  A-l,  Appendix  A. 

Layer  coefficient 

See  Table  A-2,  Appendix  A. 

Average  porosity  of  armor 

P 

% 

See  Table  A-2,  Appendix  A. 

layer 

Cotangent  of  structure 

cote 

1 .0  to  6.0 

slope 

Number  of  armor  units 

n 

1  to  3 

comprising  the 
thickness  of  the  armor 

layer 


Output 

Results  from  this  application  are  displayed  on  one  screen.  Those  data  include 
the  original  input  values  (in  final  units)  and  the  following  parameters: 


Ttem 

Symbol 

English 

Metric 

Units 

Units 

Weight  of  an  individual  armor 

w 

lb 

N 

unit 

Crest  width  of  breakwater 

B 

ft 

m 

Average  cover  layer  thickness 

r 

ft 

m 

Number  of  single  armor  units 

Nt 

per  unit  surface  area 
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Procedure 

The  bulleted  items  in  the  following  lists  indicate  potentially  optional  instruction 
steps.  Any  application  in  ACES  may  be  executed  in  a  given  session  without 
quitting  the  program.  The  bulleted  items  provide  instructions  for  accessing  the 
application  from  various  menu  areas  of  the  ACES  program.  Ignore  bulleted 
instruction  steps  that  are  not  applicable. 


Single  Case  Mode 

0  Press  (Ft)  on  the  Main  Menu  to  select  Single  Case  Mode. 

°  Fill  in  the  highlighted  input  fields  on  the  General  Specifications  screen 
(or  leave  the  default  values).  Press  (fi)  when  all  data  on  this  screen 
are  correct. 

6  Press  (F4)  on  the  Functional  Area  Menu  to  select  Wave  -  Structure 
Interaction. 

°  Press  (fT)  on  the  Structural  Design  Menu  to  select  Breakwater  Design 
Using  Hudson  and  Related  Equations. 


1.  Fill  in  the  highlighted  input  fields  on  the  screen.  Respond  to  any  corrective 
instructions  appearing  at  the  bottom  of  the  screens.  Press  (fT)  when  all  data 
on  this  screen  are  correct  or  (Ftu)to  provide  access  to  the  additional  following 
options  (choose  one): 

[fT|  Return  to  the  input  screen. 

[F3]  Display  tables  of  suggested  K d  values. 

(F4|  Display  a  table  of  suggested  values  for  P  and  ka 

[fio]  Exit  application. 


2.  All  output  data  and  selected  input  data  are  displayed  on  the  screen  in  the 
final  system  of  units. 

3.  Press  one  of  the  following  keys  to  select  the  appropriate  action: 

[fT|  Return  to  Step  1  for  a  new  case. 

(F3)  Send  a  summary  of  this  case  to  the  print  file  or  device. 
(Fio)  Exit  this  application  and  return  to  the  Structural  Design  Menu. 
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Multiple  Case  Mode 

°  Press  (F2)  on  the  Main  Menu  to  select  Multi  Case  Mode. 

°  Fill  in  the  highlighted  input  fields  on  the  General  Specifications  screen 
(or  leave  the  default  values).  Press  (fT)  when  all  data  on  this  screen 
are  correct. 

°  Press  (F4)  on  the  Functional  Area  Menu  to  select  Structural  Design. 
Press  (fT)  on  the  Structural  Design  Menu  to  select  Breakwater  Design 
Using  Hudson  and  Related  Equations. 

1.  Move  the  cursor  to  select  a  variable  on  the  Breakwater  Design  Using  Hudson 
and  Related  Equations  screen  (the  selected  variable  name  blinks).  The  current 
set  of  values  for  the  variable  is  displayed  on  the  right  portion  of  the  screen. 
When  all  variable  sets  are  correct,  go  to  Step  3. 

2.  Enter  a  set  of  values  for  the  subject  variable  by  following  one  of  the  input 
methods: 

a.  Press  ®  to  select  random  method.  Enter  up  to  20  values  constituting 
a  set  for  this  variable  (one  in  each  field)  on  the  right  side  of  the  screen. 
The  set  of  20  values  originally  displayed  (first  execution)  in  these  fields 
contains  the  "delimiting"  value,  which  "delimits"  or  "ends"  the  set.  The 
"delimiting"  value  is  not  included  as  a  member  in  the  set  unless  it  is 
the  sole  member. 

b.  Press  (7)  to  select  incremental  method.  Fill  in  the  fields  for  minimum, 
maximum,  and  increment  values  for  this  variable  on  the  right  side  of 
the  screen.  In  this  method,  the  members  of  the  set  include  all  values 
from  the  minimum  to  the  maximum  (both  inclusive)  at  the  specified 
increment. 

The  units  field  should  also  be  specified  for  the  variable  regardless  of  input 
method.  All  members  of  a  set  of  values  for  a  subject  variable  are  assigned 
the  specified  units.  When  all  data  are  correct  for  the  subject  variable,  press 
(Flo)  to  return  to  Step  1.  Errors  are  reported  at  the  bottom  of  the  screen 
and  are  corrected  by  pressing  (fT)  to  allow  respecification  of  the  data  for  the 
subject  variable. 

3.  Press  (fT|  to  process  the  cases  resulting  from  the  combinations  of  the  sets  of 
data  for  all  variables.  The  summary  of  each  case  will  be  sent  to  the  print 
file  or  device.  The  screen  will  display  the  total  number  of  cases  to  be 
processed  as  well  as  report  progress.  Errors  are  reported  at  the  bottom  of 
the  screen  and  are  corrected  by  pressing  (fT)  to  allow  respecification  of 
variable  sets. 

4.  Press  one  of  the  following  keys  to  select  the  appropriate  action: 

[fT]  Return  to  Step  1  to  specify  new  sets. 

[FlQ)  Exit  this  application  and  return  to  the  Structural  Design  Menu. 
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Example  Problem 

Input 

All  data  input  for  this  application  is  done  on  one  screen.  The  values  and 
corresponding  units  selected  for  this  example  problem  are  shown  below. 

Type  of  Armor  Unit :  Tribar,  nonbreaking  wave  on  structure  trunk  [Optional 
Input] 


Item 

Svmbol 

Value 

Units 

Armor  unit  weight 

wT 

165.00 

lb/ft3 

Wave  height 

Hi 

11.50 

ft 

Stability  coefficient 

*D 

10.00 

Layer  coefficient 

1.02 

Average  porosity  of  armor  layer 

P 

54.00 

% 

Cotangent  of  structure  slope 

COt0 

2.00 

Number  of  armor  units 

n 

2 

comprising  the  thickness  of 
the  armor  layer 


Output 

Results  from  this  application  are  displayed  on  one  screen.  These  data  include 
the  original  input  values  and  the  following  parameters: 


Item 

Svmbol 

Value 

Units 

Weight  of  an  individual  armor 
unit 

W 

1.59 

tons 

Crest  width  of  breakwater 

B 

8.21 

ft 

Average  cover  layer  thickness 

r 

5.47 

ft 

Number  of  single  armor  units 
per  unit  surface  area 

Nr 

130.30 
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Description 

Toe  protection  consists  of  armor  for  the  beach  or  bottom  material  fronting  a 
structure  to  prevent  wave  scour.  This  application  determines  armor  stone  size 
and  width  of  a  toe  protection  apron  for  vertical  faced  structures  such  as  seawalls, 
bulkheads,  quay  walls,  breakwaters,  and  groins.  Apron  width  is  determined  by 
the  geotechnical  and  hydraulic  guidelines  specified  in  Engineer  Manual 
1110-2-1614.  Stone  size  is  determined  by  a  method  (Tanimoto,  Yagyu,  and 
Goda,  1982)  whereby  a  stability  equation  is  applied  to  a  single  rubble  unit  placed 
at  a  position  equal  to  the  width  of  the  toe  apron  and  subjected  to  standing  waves. 


Input 


The  terminology  and  symbols  used  in  this  application  are  shown  in  Figures  4-2-1 
and  4-2-2. 


Figure  4-2-1.  Typical  Toe  Apron  for  Sheet-Pile  Walls 
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AH  data  input  for  this  application  is  done  on  one  screen.  The  following  list 
describes  the  necessary  input  parameters  with  their  corresponding  units  and  range 
of  data  recognized  by  this  application: 


Item 

Symbol 

Units 

Data  Ranee 

Incident  wave  height 

H  i 

ft,  m 

0.1 

to 

100.0 

Wave  period 

T 

sec 

1.0 

to 

1000.0 

Water  depth  at  structure 

dB 

ft,  m 

0.1 

to 

200.0 

Cotangent  of  nearshore 

cot4> 

5.0 

to 

10000.0 

slope 

Passive  earth  pressure 

0.0 

to 

50.0 

coefficient 

Sheet-pile  penetration 

de 

ft,  m 

0.0 

to 

200.0 

depth 

NOTE:  For  structures  without  sheet  piles,  the 
de  should  be  set  to  0.0. 

values  of  Kp 

and 

Height  of  toe  protection 

ft,  m 

0.1 

to 

200.0 

layer  above  mudline 

Unit  weight  of  rock 

WT 

lb/ft3,  N/m3 

1.0 

to 

99999.0 

Output 

Results  from  this  application  are  displayed  on  one  screen.  Those  data  include 
the  original  input  values  (in  final  units)  and  the  following  parameters: 


Item 

Symbol 

English 

Units 

Metric 

Units 

Width  of  toe  protection  apron 

B 

ft 

m 

Weight  of  individual  armor  unit 

W 

lb 

N 

Water  depth  at  top  of  toe 
protection  layer 

d\ 

ft 

m 
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Procedure 


The  bulleted  items  in  the  following  lists  indicate  potentially  optional  instruction 
steps.  Any  application  in  ACES  may  be  executed  in  a  given  session  without 
quitting  the  program.  The  bulleted  items  provide  instructions  for  accessing  the 
application  from  various  menu  areas  of  the  ACES  program.  Ignore  bulleted 
instruction  steps  that  are  not  applicable. 


Single  Case  Mode 

°  Press  (fi)  on  the  Main  Menu  to  select  Single  Case  Mode. 

°  Fill  in  the  highlighted  input  fields  on  the  General  Specifications  screen 
(or  leave  the  default  values).  Press  (fT)  when  all  data  on  this  screen 
are  correct. 

°  Press  [F4]  on  the  Functional  Area  Menu  to  select  Structural  Design. 

.  °  Press  (F2)  on  the  Structural  Design  Menu  to  select  Toe  Protection 
Design. 

1 .  Fill  in  the  highlighted  input  fields  on  the  screen.  Respond  to  any  corrective 
instructions  appearing  at  the  bottom  of  the  screens.  Press  (fi)  when  all  data 
on  this  screen  are  correct. 

2.  All  output  data  and  selected  input  data  are  displayed  on  the  screen  in  the 
final  system  of  units. 

3.  Press  one  of  the  following  keys  to  select  the  appropriate  action: 

[fi)  Return  to  Step  1  for  a  new  case. 

[F3]  Send  a  summary  of  this  case  to  the  print  file  or  device. 
(fio)  Exit  this  application  and  return  to  the  Structural  Design  Menu. 


Multiple  Case  Mode 


°  Press  [fz)  on  the  Main  Menu  to  select  Multi  Case  Mode. 

°  Fill  in  the  highlighted  input  fields  on  the  General  Specifications  screen 
(or  leave  the  default  values).  Press  @  when  all  data  on  this  screen 
are  correct. 

°  Press  (F4)  on  the  Functional  Area  Menu  to  select  Structural  Design. 

°  Press  (F2)  on  the  Structural  Design  Menu  to  select  Toe  Protection 
Design. 
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1.  Move  the  cursor  to  select  a  variable  on  the  Toe  Protection  Design  screen  (the 
selected  variable  name  blinks).  The  current  set  of  values  for  the  variable  is 
displayed  on  the  right  portion  of  the  screen.  When  all  variable  sets  are 
correct,  go  to  Step  3. 

2.  Enter  a  set  of  values  for  the  subject  variable  by  following  one  of  the  input 
methods: 

a.  Press  @  to  select  random  method.  Enter  up  to  20  values  constituting 
a  set  for  this  variable  (one  in  each  field)  on  the  right  side  of  the  screen. 
The  set  of  20  values  originally  displayed  (first  execution)  in  these  fields 
contains  the  "delimiting"  value,  which  "delimits"  or  "ends"  the  set.  The 
"delimiting"  value  is  not  included  as  a  member  in  the  set  unless  it  is 
the  sole  member. 

b.  Press  0  to  select  incremental  method.  Fill  in  the  fields  for  minimum, 
maximum,  and  increment  values  for  this  variable  on  the  right  side  of 
the  screen.  In  this  method,  the  members  of  the  set  include  all  values 
from  the  minimum  to  the  maximum  (both  inclusive)  at  the  specified 
increment. 

The  units  field  should  also  be  specified  for  the  variable  regardless  of  input 
method.  All  members  of  a  set  of  values  for  a  subject  variable  are  assigned 
the  specified  units.  When  all  data  are  correct  for  the  subject  variable,  press 
(fio]  to  return  to  Step  1.  Errors  are  reported  at  the  bottom  of  the  screen 
and  are  corrected  by  pressing  (fT)  to  allow  respecification  of  the  data  for  the 
subject  variable. 


3.  Press  (fT)  to  process  the  cases  resulting  from  the  combinations  of  the  sets  of 
data  for  all  variables.  The  summary  of  each  case  will  be  sent  to  the  print 
file  or  device.  The  screen  will  display  the  total  number  of  cases  to  be 
processed  as  well  as  report  progress.  Errors  are  reported  at  the  bottom  of 
the  screen  and  are  corrected  by  pressing  (fi)  to  allow  respecification  of 
variable  sets. 


4.  Press  one  of  the  following  keys  to  select  the  appropriate  action: 

(fT)  Return  to  Step  1  to  specify  new  sets. 

[fio]  Exit  this  application  and  return  to  the  Structural  Design  Menu. 
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Example  Problems 


Example  1  -  Toe  Protection  for  a  Bulkhead 
Input 

All  data  input  for  this  application  is  done  on  one  screen.  The  values  and 
corresponding  units  selected  for  this  first  example  problem  are  shown  below. 


Item 

Svmbol 

Value 

Units 

Incident  wave  height 

H\ 

5.00 

ft 

Wave  period 

T 

12.00 

sec 

Water  depth  at  structure 

da 

20.00 

ft 

Cotangent  of  nearshore  slope 

cotljl 

100.00 

Passive  earth  pressure 

Kv 

1.50 

coefficient 

Sheet-pile  penetration  depth 

d e 

10.00 

ft 

Height  of  toe  protection 

K 

4.50 

ft 

layer  above  mudline 

Unit  weight  of  rock 

WT 

165.00 

lb/ft3 

Output 

Results  from  this  application  are  displayed  on  one  screen.  Those  data  include 
the  original  input  values  and  the  following  parameters  (see  Figure  4-2-3  for 
location  of  parameters): 


Item  Symbol  Value 

Width  of  toe  protection  apron  B  15.00 

Weight  of  individual  armor  unit  W  12.99 

Water  depth  at  top  of  toe  d\  15.50 

protection  layer 


Figure  4-2-3.  Toe  Protection  for  Bulkhead  Example  Output 


Units 

ft 

lb 

ft 
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Example  2  -  Toe  Protection  for  a  Vertical  Breakwater 
Input 

All  data  input  for  this  application  is  done  on  one  screen.  The  values  and 
corresponding  units  selected  for  this  example  problem  are  shown  below. 


Item 

Symbol 

Value 

Units 

Incident  wave  height 

Hi 

5.00 

ft 

Wave  period 

T 

12.00 

sec 

Water  depth  at  structure 

ds 

20.00 

ft 

Cotangent  of  nearshore  slope 

cotl t> 

100.00 

Passive  earth  pressure 

0.00 

coefficient 

Sheet- pile  penetration  depth 

de 

0.00 

Height  of  toe  protection 

hh 

4.50 

ft 

layer  above  mudline 

Unit  weight  of  rock 

165.00 

lb/ft3 

Output 

Results  from  this  application  are  displayed  on  one  screen.  Those  data  include 

the  original  input  values  and  the 

following 

parameters  (see  Figure  4-2-4  for 

location  of  parameters): 

Item 

Symbol 

Value 

Units 

Width  of  toe  protection  apron 

.  B 

10.00 

ft 

Weight  of  individual  armor  unit 

W 

4.836 

lb 

Water  depth  at  top  of  toe 

d\ 

15.50 

ft 

protection  layer 

Figure  4-2-4.  Toe  Protection  for  Vertical  Breakwater  Example  Output 
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Nonbreaking  Wave  Forces  at  Vertical  Walls 


Description 

This  application  provides  the  pressure  distribution  and  resultant  force  and  moment 
loading  on  a  vertical  wall  caused  by  normally  incident,  nonbreaking,  regular 
waves  as  proposed  by  Sainflou  (1928),  Miche  (1944),  and  Rundgren  (1958).  The 
results  can  be  used  to  design  vertical  structures  in  protected  or  fetch-limited 
regions  when  the  water  depth  at  the  structure  is  greater  than  about  1.5  times  the 
maximum  expected  wave  height.  Both  the  Sainflou  and  Miche-Rundgren  theories 
are  used  by  this  application  to  determine  wave-induced  pressure  distribution  on 
a  vertical  wall.  Sainflou’s  theory  is  more  appropriate  for  measuring  results  of 
long,  nonbreaking  waves  of  low  steepness,  but  it  overpredicts  as  the  waves  become 
steeper.  The  Miche-Rundgren  theory  provides  more  accurate  results  for  steep, 
nonbreaking  waves,  but  the  theory  begins  to  overpredict  as  the  wavelength  is 
increased.  Given  wave  properties  and  a  wave  reflection  coefficient,  this 
application  presents  results  of  each  theory  with  a  recommendation  of  using  results 
from  the  theory  giving  lower  values  for  force  and  moment.  This  application 
provides  the  same  results  as  found  using  the  design  curves  given  in  Chapter  7 
of  the  SPM  (1984). 


Input 

The  terminology  used  to  define  w'ave  forces  at  vertical  walls  is  shown  in  Figure 
4-3-1. 
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All  data  input  for  this  application  is  done  on  one  screen.  The  following  list 
describes  the  necessary  input  parameters  with  their  corresponding  units  and  range 
of  data  recognized  by  this  application: 


Item  Symbol 

Depth  for  SWL  d 

Incident  wave  height  H , 

Wave  period  T 

Wave  reflection  coefficient  X 

Cotangent  of  nearshore  cot<|> 

slope 


Units 

Data  Range 

ft,  m 

0.1 

to 

200.0 

ft,  m 

0.1 

to 

100.0 

sec 

1.0 

to 

100.0 

0.9 

to 

1.0 

5.0 

to 

10000.0 

Output 

Results  from  this  application  are  displayed  on  one  screen.  In  addition,  there  is 
an  option  (available  in  Single  Case  Mode  only)  to  send  data  to  a  plot  output  file 
(default  name  PLOTDATl.OUT).  This  application  also  generates  four  screen 
plots.  Each  of  these  outputs  is  described  below. 


Screen  Output 


Results  from  this  application  are  displayed  on  one  screen.  Those  data  includes 
the  original  input  values  (in  final  units)  and  the  following  parameters  at  the 
wave  crest  and  trough  for  both  the  Miche-Rundgren  and  Sainflou  methods: 


Item 

Wave  crest  and  trough  positions 
at  wall  (measured  from  the 
bottom) 

Integrated  wave  force 
Integrated  moment  about  base 


Symbol  English  Metric 

Units  Units 

ft  m 

lb/ft  n/m 

lb-ft/ft  n-m/m 


Also  displayed  on  the  screen  is  a  recommendation  to  use  results  from  the  method 
yielding  the  lower  values  for  force  and  moment. 
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Plot  Output  File  1 

Plot  output  file  1  contains  the  Miche-Rundgren  and  Sainflou  pressure  distribution 
for  both  the  wave  crest  and  trough  at  the  wall  and  is  written  in  the  following 
format  (see  Table  4-3-1  in  the  example  problem): 


Field 

Columns 

Format 

Data 

1 

1-3 

13 

Point  Counter 

2 

5-14 

F10.2 

Elevation 

3 

19-28 

F10.2 

Wave  Pressure 

4 

33-42 

FI  0.2 

Hydrostatic  Pressure 

5 

50-59 

F10.2 

Wave  and  Hydrostatic  Pressure 

Screen  Plots 

This  application  generates  four  plots  showing  pressure  distribution  for  both  the 
Miche-Rundgren  and  Sainflou  methods  with  the  wave  crest  and  trough  at  the 
wall.  Three  curves  per  plot  are  plotted  including  the  individual  wave  and 
hydrostatic  pressure  and  the  sum  of  the  wave  and  hydrostatic  pressure  (see  Figures 
4-3-2  through  4-3-5  in  the  example  problem). 


Procedure 

The  bulleted  items  in  the  following  lists  indicate  potentially  optional  instruction 
steps.  Any  application  in  ACES  may  be  executed  in  a  given  session  without 
quitting  the  program.  The  bulleted  items  provide  instructions  for  accessing  the 
application  from  various  menu  areas  of  the  ACES  program.  Ignore  bulleted 
instruction  steps  that  are  not  applicable. 


Single  Case  Mode 

°  Press  (fT)  on  the  Main  Menu  to  select  Single  Case  Mode. 

0  Fill  in  the  highlighted  input  fields  on  the  General  Specifications  screen 
(or  leave  the  default  values).  Press  [Ft]  when  all  data  on  this  screen 
are  correct. 

°  Press  (F4)  on  the  Functional  Area  Menu  to  select  Structural  Design. 
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°  Press  [F3]  on  the  Structural  Design  Menu  to  select  Nonbreaking  Wave 
Forces  at  Vertical  Walls. 

1 .  Fill  in  the  highlighted  input  fields  on  the  Nonbreaking  Wave  Forces  at  Vertical 
Walls  screen.  Respond  to  any  corrective  instructions  appearing  at  the  bottom 
of  the  screen.  Press  @  when  all  data  on  this  screen  are  correct. 

2.  All  input  and  output  data  are  displayed  on  the  screen  in  the  final  system  of 
units. 

3.  Press  one  of  the  following  keys  to  select  the  appropriate  action; 

(Fl)  Return  to  Step  1  for  a  new  case. 

(F2)  Plot  pressure  data. 

(F3)  Send  a  summary  of  this  case  to  the  print  file  or  device. 

[F4]  Generate  a  file  containing  the  plot  data  (Plot  Output  File  1). 
[fio]  Exit  this  application  and  return  to  the  Structural  Design  Menu. 


Multiple  Case  Mode 

°  Press  (F2)  on  the  Main  Menu  to  select  Multi  Case  Mode. 

0  Fill  in  the  highlighted  input  fields  on  the  General  Specifications  screen 
(or  leave  the  default  values).  Press  (Fl)  when  all  data  on  this  screen 
are  correct. 

°  Press  (F4)  on  the  Functional  Area  Menu  to  select  Structural  Design. 

0  Press  (F3)  on  the  Structural  Design  Menu  to  select  Nonbreaking  Wave 
Forces  at  Vertical  Walls. 

1.  Press  (rT)  to  enter  Multi  Case  data  entry  mode. 

2.  Move  the  cursor  to  select  a  variable  on  the  Nonbreaking  Wave  Forces  at 
Vertical  Walls  screen  (the  selected  variable  name  blinks).  The  current  set  of 
values  for  the  variable  is  displayed  on  the  right  portion  of  the  screen.  When 
all  variable  sets  are  correct,  go  to  Step  3. 

3.  Enter  a  set  of  values  for  the  subject  variable  by  following  one  of  the  input 
methods; 

a.  Press  ®  to  select  random  method.  Enter  up  to  20  values  constituting 
a  set  for  this  variable  Cone  in  each  field)  on  the  right  side  of  the  screen. 
The  set  of  20  values  originally  displayed  (first  execution)  in  these  fields 
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contains  the  "delimiting"  value,  which  "delimits"  or  "ends"  the  set.  The 
"delimiting"  value  is  not  included  as  a  member  in  the  set  unless  it  is 
the  sole  member. 

b.  Press  QQ  to  select  incremental  method.  Fill  in  the  fields  for  minimum, 
maximum,  and  increment  values  for  this  variable  on  the  right  side  of 
the  screen.  In  this  method,  the  members  of  the  set  include  all  values 
from  the  minimum  to  the  maximum  (both  inclusive)  at  the  specified 
increment. 


The  units  field  should  also  be  specified  for  the  variable  regardless  of  input 
method.  All  members  of  a  set  of  values  for  a  subject  variable  are  assigned 
the  specified  units.  When  all  data  are  correct  for  the  subject  variable,  press 
[fio]  to  return  to  Step  1.  Errors  are  reported  at  the  bottom  of  the  screen 
and  are  corrected  by  pressing  (|T)  to  allow  respecification  of  the  data  for  the 
subject  variable. 


4.  Press  (fT)  to  process  the  cases  resulting  from  the  combinations  of  the  sets  of 
data  for  all  variables.  The  summary  of  each  case  will  be  sent  to  the  print 
file  or  device.  The  screen  will  display  the  total  number  of  cases  to  be 
processed  as  well  as  report  progress.  Errors  are  reported  at  the  bottom  of 
the  screen  and  are  corrected  by  pressing  (fi)  to  allow  respecification  of 
variable  sets. 


5.  Press  one  of  the  following  keys  to  select  the  appropriate  action: 


(fi)  Return  to  Step  1  to  specify  new  sets. 

(fio)  Exit  this  application  and  return  to  the  Structural  Design  Menu. 


NOTE:  Multiple  Case  Mode  does  not  generate  any  plot  output 
files  or  plots. 
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Input 

All  data  input  for  this  application  is  done  on  one  screen.  The  values  and 
corresponding  units  selected  for  this  example  problem  are  shown  below. 


Item 

Symbol 

Value 

Units 

Depth  for  SWL 

d 

15.0 

ft 

Incident  wave  height 

8.0 

ft 

Wave  period 

T 

10.0 

sec 

Wave  reflection  coefficient 

X 

1.0 

Cotangent  of  nearshore  slope 

cot<t> 

100.0 

Output 

Results  from  this  application  are  displayed  on  one  screen  and,  if  requested  (in 
Single  Case  only),  written  to  plot  output  file  1.  In  addition,  four  plots  are 
generated.  Each  of  these  outputs  for  the  example  problem  is  presented  below. 


Screen  Output 

Results  from  this  application  are  displayed  on  one  screen.  Those  data  include 
the  original  input  values  and  the  following  parameters: 


MICHE-RUNDGREN 

SAINFLOU 

Wave  Position  at 
Wall 

Crest 

Trough 

Crest 

Trough 

Units 

Hgt  above  Bottom 

32.95 

16.95 

32.95 

16.95 

ft 

Integrated  Force 

28683.39 

7121.92 

17724.17 

2323.04 

lb/ft 

Integrated  Moment 
about  Base 

306958.40 

38825.47 

148008.60 

7214.73 

lb-ft/ft 

NOTE:  Sainflou  results  are  recommended  for  this  case. 
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Plot  Output  File  1 

Table  4-3-1  below  is  a  partial  listing  of  plot  output  file  1  (default  name 
PLOTDATl.OUT)  generated  by  this  application  for  the  example  problem. 


Table  4-3-1 

Partial  Listing  of  Plot  Output  File  1  for  Example  Problem 


Miche-Rundgren  Pressure  Distribution 
Crest  at  Wall  (Figure  4-3-2) 


Elevation 

(ft) 

Wave 

Pressure 

(lb/ft2) 

Hydrostatic 

Pressure 

(lb/ft2) 

Wave  & 
Hydrostatic 
Pressure 
(lb/ft2) 

1 

-15.00 

871.49 

959.79 

1831.28 

2 

-14.65 

871.52 

937.40 

1808.92 

3 

-14.30 

871.62 

915.00 

1786.62 

4 

-13.95 

871.78 

892.60 

1764.38 

5 

-13.60 

872.01 

870.20 

1742.21 

6 

-13.25 

872.30 

847.79 

1720.09 

7 

-12.90 

872.65 

825.39 

1698.04 

8 

-12.55 

873.07 

802.97 

1676.05 

9 

-12.20 

873.56 

780.56 

1654.12 

1 

i 

i 

l 

83 

14.79 

152.88 

0.00 

152.88 

84 

15.18 

133.71 

0.00 

133.71 

85 

15.57 

114.56 

0.00 

114.56 

86 

15.96 

95.43 

0.00 

95.43 

87 

16.36 

76.31 

0.00 

76.31 

88 

16.75 

57.21 

0.00 

57.21 

89 

17.15 

38.13 

0.00 

38.13 

90 

17.55 

19.06 

0.00 

19.06 

91 

17.95 

0.00 

0.00 

0.00 

(Table  4-3-1  Continued  on  the  Next  Page) 
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(Table  4-3-1  Continued) 
Miche-Rundgren  Pressure  Distribution 
Trough  at  Wall  (Figure  4-3-3) 


Elevation 

(ft) 

Wave 

Pressure 

(lb/ft2) 

Hydrostatic 

Pressure 

(lb/ft2) 

Wave  & 
Hydrostatic 
Pressure 
(lb/ft2) 

1 

-15.00 

-465.53 

959.79 

494.26 

2 

-14.82 

-459.31 

948.41 

489.10 

3 

-14.64 

-453.10 

937.02 

483.92 

4 

-14.47 

-446.90 

925.64 

478.74 

5 

-14.29 

-440.71 

914.25 

473.54 

6 

-14.11 

-434.53 

902.86 

468.33 

7 

-13.93 

-428.35 

891.47 

463.11 

8 

-13.75 

-422.19 

880.07 

457.89 

9 

-13.58 

-416.03 

868.68 

452.65 

1 

11 

1 

l 

i 

83 

0.29 

45.25 

0.00 

45.25 

84 

0.50 

39.59 

0.00 

39.59 

85 

0.70 

33.94 

0.00 

33.94 

86 

0.91 

28.28 

0.00 

28.28 

87 

1.11 

22.63 

0.00 

22.63 

88 

1.32 

16.97 

0.00 

16.97 

89 

1.53 

11.31 

0.00 

11.31 

90 

1.74 

5.66 

0.00 

5.66 

91 

1.95 

0.00 

0.00 

0.00 

Sainflou  Pressure  Distribution 

Crest  at  Wall  (Figure  4-3-4) 

Elevation 

(ft) 

Wave 

Pressure 

(lb/ft2) 

Hydrostatic 

Pressure 

(Ib/ft2) 

Wave  & 
Hydrostatic 
Pressure 
(lb/ft2) 

1 

-15.00 

465.53 

959.79 

1425.32 

2 

-14.73 

466.96 

942.20 

1409.16 

(Table  4-3-1  Continued  on  the  Next  Page) 
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(Table  4-3-1  Continued) 


3 

-14.45 

468.40 

924.61 

1393.00 

4 

-14.18 

469.85 

907.02 

1376.86 

5 

-13.90 

471.31 

889.42 

1360.73 

6 

-13.63 

472.78 

871.83 

1344.61 

7 

-13.35 

474.27 

854.23 

1328.50 

8 

-13.08 

475.76 

836.63 

1312.40 

9 

-12.80 

477.27 

819.03 

1296.31 

11 

A 

1 

11 

11 

83 

7.94 

125.38 

0.00 

125.38 

84 

8.23 

109.71 

0.00 

109.71 

85 

8.52 

94.03 

0.00 

94.03 

86 

8.81 

78.36 

0.00 

78.36 

87 

9.10 

62.69 

0.00 

62.69 

88 

9.39 

47.02 

0.00 

47.02 

89 

9.69 

31.34 

0.00 

31.34 

90 

9.98 

15.67 

0.00 

15.67 

91 

17.95 

0.00 

0.00 

0.00 

Sainflou  Pressure  Distribution 
Trough  at  Wall  (Figure  4-3-5) 


Elevation 

(ft) 

Wave 

Pressure 

(lb/ft2) 

Hydrostatic 

Pressure 

(lb/ft2) 

Wave  & 
Hydrostatic 
Pressure 
(lb/ft2) 

1 

-15.00 

-465.53 

959.79 

494.26 

2 

-14.90 

-464.11 

953.21 

489.10 

3 

-14.79 

-462.71 

946.63 

483.92 

4 

-14.69 

-461.32 

940.05 

478.74 

5 

-14.59 

-459.93 

933.47 

473.54 

6 

-14.49 

-458.56 

926.89 

468.33 

7 

-14.38 

-457.20 

920.31 

463.11 

8 

-14,28 

-455.85 

913.73 

457.89 

9 

-14.18 

-454.51 

907.15 

452.65 

1 

1 

11 

11 

11 

(Table  4-3-1  Continued  on  the  Next  Page) 
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(Table  4-3-1  Concluded) 


83 

-6.56 

-374.30 

419.54 

45.25 

84 

-6.45 

-373.33 

412.93 

39.59 

85 

-6.35 

-372.37 

406.31 

33.94 

86 

-6.25 

-371.41 

399.69 

28.28 

87 

-6.14 

-370.45 

393.07 

22.63 

88 

-6.04 

-369.48 

386.45 

16.97 

89 

-5.94 

-368.52 

379.83 

11.31 

90 

-5.83 

-367.55 

373.21 

5.66 

91 

1.95 

0.00 

0.00 

0.00 

Screen  Plot 

This  application  generates  four  plots.  The  plots  may  be  accessed  from  the 
Nonbreaking  Waye  Forces  on  Vertical  Walls  Plot  Selection  Menu,  which  appears 
when  the  Plot  Pressure  Data  option  ((F2])  from  the  input  screen  is  requested. 
To  access  a  plot,  move  the  cursor  (using  the  arrow  keys)  to  the  desired  plot  and 
press  (fT).  (Appendix  C  describes  options  to  customize  plots.)  The  plots  generated 
for  this  example  problem  are  shown  below. 
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Description 

Quarrystone  is  the  most  commonly  used  material  for  protecting  earth 
embankments  from  wave  attack  because,  where  available,  high-quality  stone 
provides  a  stable  and  unusually  durable  revetment  armor  material  at  relatively 
low  cost.  This  ACES  application  provides  estimates  for  revetment  armor  and 
bedding  layer  stone  sizes,  thicknesses,  and  gradation  characteristics.  Also 
calculated  are  two  values  of  runup  on  the  revetment,  an  expected  extreme  and 
a  conservative  runup  value. 

Input 

All  data  input  for  this  application  is  done  on  one  screen.  The  following  list 
describes  the  necessary  input  parameters  with  their  corresponding  units  and  range 
of  data  recognized  by  this  application: 


Item 

Svmbol 

Units 

Data  Ranee 

Significant  wave  height 

hb 

ft,  m 

0.1 

to 

100.0 

Significant  wave  period 

Ts 

sec 

i.O 

to 

1000.0 

Cotangent  nearshore  slope 

cot  i|) 

5.0 

to 

10000.0 

Water  depth  at  toe  of 

de 

ft,  m 

0.1 

to 

200.0 

revetment 

Cotangent  of  structure 

cotO 

2.0 

to 

6.0 

slope 

Unit  weight  of  rock 

lb/ft3,  N/m8 

1.0 

to 

99999.0 

Permeability  coefficient 

P 

0.05 

to 

0.6 

Damage  level 

s 

2 

to 

17 

Output 

Results  from  this  application  are  displayed  on  one  screen.  The  results  include 
the  armor  and  filter  layer  thicknesses,  stone  size  gradations  (weight  and  size), 
and  an  expected  extreme  and  conservative  runup  on  the  riprap  revetment. 


Item 

Svmbol 

English 

Units 

Metric 

Units 

Weight  of  individual  armor  and 
filter  stone 

W 

lb 

N 

Armor/filter  layer  thickness 

r 

ft 

m 

Runup  (expected  maximum  and 
conservative) 

R 

ft 

m 
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Procedure 

The  bulleted  items  in  the  following  lists  indicate  potentially  optional  instruction 
steps.  Any  application  in  ACES  may  be  executed  in  a  given  session  without 
quitting  the  program.  The  bulleted  items  provide  instructions  for  accessing  the 
application  from  various  menu  areas  of  the  ACES  program.  Ignore  bulleted 
instruction  steps  that  are  not  applicable. 


Single  Case  Mode 

°  Press  (fT|  on  the  Main  Menu  to  select  Single  Case  Mode. 

°  Fill  in  the  highlighted  input  fields  on  the  General  Specifications  screen 
(or  leave  the  default  values).  Press  (fi)  when  all  data  on  this  screen 
are  correct. 

°  Press  |F4)  on  the  Functional  Area  Menu  to  select  Structural  Design. 

°  Press  (F4)  on  the  Structural  Design  Menu  to  select  Rubble-Mound 
Revetment  Design. 

1.  Fill  in  the  highlighted  input  fields  on  the  screen.  Respond  to  any  corrective 
instructions  appearing  at  the  bottom  of  the  screens.  Press  (fT)  when  all  data 
on  this  screen  are  correct. 

2.  All  output  data  are  displayed  on  the  screen  in  the  final  system  of  units. 

3.  Press  one  of  the  following  keys  to  select  the  appropriate  action: 

(fT)  Return  to  Step  1  for  a  new  case. 

[f3]  Send  a  summary  of  this  case  to  the  print  file  or  device. 
[fio]  Exit  this  application  and  return  to  the  Structural  Design  Menu. 


Multiple  Case  Mode 

°  Press  (F2)  on  the  Main  Menu  to  select  Multi  Case  Mode. 

°  Fill  in  the  highlighted  input  fields  on  the  General  Specifications  screen 
(or  leave  the  default  values).  Press  (fi)  when  all  data  on  this  screen 
are  correct. 

Press  (F4)  on  the  Functional  Area  Menu  to  select  Structural  Design. 

°  Press  fF4)  on  the  Structural  Design  Menu  to  select  Rubble-Mound 
Revetment  Design. 
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1.  Move  the  cursor  to  select  a  variable  on  the  Rubble-Mound  Revetment  Design 
screen  (the  selected  variable  name  blinks).  The  current  set  of  values  for  the 
variable  is  displayed  on  the  right  portion  of  the  screen.  When  all  variable 
sets  are  correct,  go  to  Step  3. 

2.  Enter  a  set  of  values  for  the  subject  variable  by  following  one  of  the  input 
methods: 

a.  Press  ®  to  select  random  method.  Enter  up  to  20  values  constituting 
a  set  for  this  variable  (one  in  each  field)  on  the  right  side  of  the  screen. 
The  set  of  20  values  originally  displayed  (first  execution)  in  these  fields 
contains  the  "delimiting"  value,  which  "delimits"  or  "ends"  the  set.  The 
"delimiting"  value  is  not  included  as  a  member  in  the  set  unless  it  is 
the  sole  member. 

b.  Press  (T)  to  select  incremental  method.  Fill  in  the  fields  for  minimum, 
maximum,  and  increment  values  for  this  variable  on  the  right  side  of 
the  screen.  In  this  method,  the  members  of  the  set  include  all  values 
from  the  minimum  to  the  maximum  (both  inclusive)  at  the  specified 
increment. 

The  units  field  should  also  be  specified  for  the  variable  regardless  of  input 
method.  All  members  of  a  set  of  values  for  a  subject  variable  are  assigned 
the  specified  units.  When  all  data  are  correct  for  the  subject  variable,  press 
(fio]  to  return  to  Step  1.  Errors  are  reported  at  the  bottom  of  the  screen 
and  are  corrected  by  pressing  (fi)  to  allow  respecification  of  the  data  for  the 
subject  variable. 


3.  Press  @  to  process  the  cases  resulting  from  the  combinations  of  the  sets  of 
data  for  all  variables.  The  summary  of  each  case  will  be  sent  to  the  print 
file  or  device.  The  screen  will  display  the  total  number  of  cases  to  be 
processed  as  well  as  report  progress.  Errors  are  reported  at  the  bottom  of 
the  screen  and  are  corrected  by  pressing  (fT)  to  allow  respecification  of 
variable  sets. 


4.  Press  one  of  the  following  keys  to  select  the  appropriate  action: 

|fT)  Return  to  Step  1  to  specify  new  sets. 

[Fio]  Exit  this  application  and  return  to  the  Structural  Design  Menu. 
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Input 

All  data  input  for  this  application  is  done  on  one  screen.  The  values  and 
corresponding  units  selected  for  this  example  problem  are  shown  below. 


Item 

Svmbol 

Value 

Units 

Significant  wave  height 

hb 

5.0 

ft 

Significant  wave  period 

tb 

10.0 

sec 

Cotangent  nearshore  slope 

cot  lj) 

100.0 

Water  depth  at  toe  of  revetment 

d. 

9.0 

ft 

Cotangent  of  structure  slope 

COt0 

2.0 

Unit  weight  of  rock 

wT 

165.0 

lb/ft3 

Permeability  coefficient 

p 

0.1 

Damage  level 

S 

2.0 

Output 

Results  from  this  application  are  displayed  on  one  screen.  The  results  include 
the  armor  and  filter  layer  thicknesses,  stone  size  gradations  (weight  and  size), 
and  an  expected  extreme  and  conservative  runup  on  the  riprap  revetment. 


ARMOR  LAYER  Thickness  =  4.95  ft 


PERCENT  LESS 

WEIGHT 

DIMENSION 

THAN  BY  WEIGHT 

(lbs) 

(ft) 

0.00 

313.08 

1.24 

15.00 

1001.84 

1.82 

50.00 

2504.61 

2.48 

85.00 

4909.04 

3.10 

100.00 

10018.44 

3.93 

FILTER  LAYER  Thickness  = 

1.24  ft 

PERCENT  LESS 

WEIGHT 

DIMENSION 

THAN  BY  WEIGHT 

(lbs) 

(ft) 

0.00 

0.82 

0.17 

15.00 

1.38 

0.20 

50.00 

4.65 

0.30 

85.00 

15.65 

0.46 

100.00 

26.35 

0.54 

IRREGULAR  WAVE  RUNUP 
EXPECTED  MAXIMUM  =  10.96  ft 
CONSERVATIVE  =  13.79  ft 
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Irregular  Wave  Runup  on  Beaches 


Description 


This  application  provides  an  approach  to  calculate  runup  statistical  parameters 
for  wave  runup  on  smooth  slope  linear  beaches.  To  account  for  permeable  and 
rough  slope  natural  beaches,  the  present  approach  needs  to  be  modified  by 
multiplying  the  results  for  the  smooth  slope  linear  beaches  by  a  reduction  factor. 
However,  there  is  no  guidance  for  such  a  reduction  due  to  the  sparcity  of  good 
field  data  on  wave  runup.  The  approach  used  in  this  ACES  application  is  based 
on  existing  laboratory  data  on  irregular  wave  runup  (Mase  and  Iwagaki,  1984; 
Mase,  1989). 


Input 


All  data  input  for  this  application  is  done  on  one  screen.  The  following  list 
describes  the  necessary  input  parameters  with  their  corresponding  units  and  range 
of  data  recognized  by  this  application: 


Item 

Symbol 

Units 

Data  Range 

Deepwater  significant  wave 
height 

ft,  m 

0.1 

to 

100.0 

Peak  energy  wave  period 

sec 

0.1 

to 

100.0 

Cotangent  of  foreshore 

cotQ 

0.1 

to 

100.0 

slope 

Output 


Results  from  this  application  are  displayed  on  one  screen.  Those  data  include 
the  original  input  values  (in  final  units)  and  the  following  parameter: 


Item 

Symbol 

English 

Metric 

Units 

Units 

Runup 

Maximum  runup 

R  max 

ft 

m 

Runup  exceeded  by  2  percent  of  the  runups 

Rz 

ft 

m 
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Average  of  the  highest  one-tenth  of  the  R\no  ft  m 

runups 

Average  of  the  highest  one-third  of  the  R  i/3  ft  m 

runups 

Average  runup  R  ft  m 


Procedure 


The  bulleted  items  in  the  following  lists  indicate  potentially  optional  instruction 
steps.  Any  application  in  ACES  may  be  executed  in  a  given  session  without 
quitting  the  program.  The  bulleted  items  provide  instructions  for  accessing  the 
application  from  various  menu  areas  of  the  ACES  program.  Ignore  bulleted 
instruction  steps  that  are  not  applicable. 


Single  Case  Mode 

“  Press  (fT)  on  the  Main  Menu  to  select  Single  Case  Mode. 

0  Fill  in  the  highlighted  input  fields  on  the  General  Specifications  screen 
(or  leave  the  default  values).  Press  (tH)  when  all  data  on  this  screen 
are  correct. 

°  Press  (fb)  on  the  Functional  Area  Menu  to  select  Wave  Runup, 
Transmission,  and  Overtopping. 

°  Press  (fI)  on  the  Wave  Runup,  Transmission,  and  Overtopping 
Application  Menu  to  select  Irregular  Wave  Runup  on  Beaches. 

1.  Fill  in  the  highlighted  input  fields  on  the  Irregular  Wave  Runup  on  Beaches 
screen.  Respond  to  any  corrective  instructions  appearing  at  the  bottom  of 
the  screen.  Press  (fi)  when  all  data  on  this  screen  are  correct. 

2.  All  input  and  output  data  are  displayed  on  the  screen  in  the  final  system  of 
units. 

3.  Press  one  of  the  following  keys  to  select  the  appropriate  action: 

(Fi)  Return  to  Step  1  for  a  new  case. 

(F3)  Send  a  summary  of  this  case  to  the  print  file  or  device. 

(fio)  Exit  this  application  and  return  to  the  Wave  Runup, 
Transmission,  and  Overtopping  Menu. 
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Multiple  Case  Mode 

°  Press  (F2)  on  the  Main  Menu  to  select  Multi  Case  Mode. 

°  Fill  in  the  highlighted  input  fields  on  the  General  Specifications  screen 
(or  leave  the  default  values).  Press  (ED  when  all  data  on  this  screen 
are  correct. 

0  Press  (ED  on  the  Functional  Area  Menu  to  select  Wave  Runup, 
Transmission,  and  Overtopping. 

°  Press  (ED  on  the  Wave  Runup,  Transmission,  and  Overtopping 
Application  Menu  to  select  Irregular  Wave  Runup  on  Beaches. 


1.  Move  the  cursor  to  select  a  variable  on  the  Irregular  Wave  Runup  on  Beaches 
screen  (the  selected  variable  name  blinks).  The  current  set  of  values  for  the 
variable  is  displayed  on  the  right  portion  of  the  screen.  When  all  variable 
sets  are  correct,  go  to  Step  3. 

2.  Enter  a  set  of  values  for  the  subject  variable  by  following  one  of  the  input 
methods: 

a.  Press  @  to  select  random  method.  Enter  up  to  20  values  constituting 
a  set  for  this  variable  (one  in  each  field)  on  the  right  side  of  the  screen. 
The  set  of  20  values  originally  displayed  (first  execution)  in  these  fields 
contains  the  ''delimiting'1  value,  which  "delimits"  or  "ends"  the  set.  The 
"delimiting"  value  is  not  included  as  a  member  in  the  set  unless  it  is 
the  sole  member. 

b.  Press  (T)  to  select  incremental  method.  Fill  in  the  fields  for  minimum, 
maximum,  and  increment  values  for  this  variable  on  the  right  side  of 
the  screen.  In  this  method,  the  members  of  the  set  include  all  values 
from  the  minimum  to  the  maximum  (both  inclusive)  at  the  specified 
increment. 

The  units  field  should  also  be  specified  for  the  variable  regardless  of  input 
method.  All  members  of  a  set  of  values  for  a  subject  variable  are  assigned 
the  specified  units.  When  all  data  are  correct  for  the  subject  variable,  press 
(fio)  to  return  to  Step  1.  Errors  are  reported  at  the  bottom  of  the  screen 
and  are  corrected  by  pressing  (ED  to  allow  respecification  of  the  data  for  the 
subject  variable. 


3.  Press  (ED  to  process  the  cases  resulting  from  the  combinations  of  the  sets  of 
data  for  all  variables.  The  summary  of  each  case  will  be  sent  to  the  print 
file  or  device.  The  screen  will  display  the  total  number  of  cases  to  be 
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processed  as  well  as  report  progress.  Errors  are  reported  at  the  bottom  of 
the  screen  and  are  corrected  by  pressing  (fT)  to  allow  respecification  of 
variable  sets. 

4.  Press  one  of  the  following  keys  to  select  the  appropriate  action: 

[fi)  Return  to  Step  1  to  specify  new  sets. 

(fio)  Exit  this  application  and  return  to  the  Wave  Runup, 
Transmission,  and  Overtopping  Menu. 


Example  Problem 

Input 

All  data  input  for  this  application  is  done  on  one  screen.  The  values  and 


corresponding  units  selected  for  this  first  example  problem  are  shown  below. 

Item 

Svmbol 

Value 

Units 

Deepwater  significant  wave 

Hso 

4.60 

ft 

height 

Peak  energy  wave  period 

9.50 

sec 

Cotangent  of  foreshore  slope 

cot  9 

13.00 

Output 

Results  from  this  application  are  displayed  on  one 

screen.  Those  data  include 

the  original  input  values  and  the  following  parameters: 

Item 

Svmbol 

Value 

Units 

Maximum  runup 

E> 

^  max 

8.74 

ft 

Runup  exceeded  by  2  percent  of 

*2 

7.11 

ft 

the  runups 

Average  of  the  highest 

R  i/io 

6.50 

ft 

one-tenth  of  the  runups 

Average  of  the  highest 

R  1/3 

5.29 

ft 

one-third  of  the  runups 

Average  runup 

R 

3.38 

ft 
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Description 

This  application  provides  estimates  of  wave  runup  and  overtopping  on  rough 
and  smooth  slope  structures  that  are  assumed  to  be  impermeable.  Run-up  heights 
and  overtopping  rates  are  estimated  independently  or  jointly  for  monochromatic 
or  irregular  waves  specified  at  the  toe  of  the  structure.  The  empirical  equations 
suggested  by  Ahrens  and  McCartney  (1975),  Ahrens  and  Titus  (1985),  and  Ahrens 
and  Burke  (1987)  are  used  to  predict  runup,  and  Weggel  (1976)  to  predict 
overtopping.  Irregular  waves  are  represented  by  a  significant  wave  height  and 
are  assumed  to  conform  to  a  Rayleigh  distribution  (Ahrens,  1977).  The 
overtopping  rate  is  estimated  by  summing  the  overtopping  contributions  from 
individual  runups  in  the  distribution. 


Input 


The  terminology  used  to  define  wave  runup  is  shown  in  Figure  5-2-1. 


All  data  input  for  this  application  is  done  on  one  screen.  The  following  list 
describes  the  necessary  input  parameters  with  their  corresponding  units  and  range 
of  data  recognized  by  this  application: 
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Mandatory  Item 

Svmbol 

Units 

Data  Ran 

ge 

Incident  wave  height 

ft,  m 

0.1 

to 

100.0 

Wave  period 

T 

sec 

1.0 

to 

1000.0 

Cotan  of  nearshore  slope 

cot 

5.0 

to 

10000.0 

Water  depth  at  structure 
toe 

d. 

ft,  m 

0.1 

to 

200.0 

Cotan  of  structure  slope 

cot  o 

0.0 

to 

30.0 

NOTE:  For  vertical  walls,  specify  0.0. 


Structure  height  above  toe  ha  ft,  m  0.0  to  200.0 


The  above  input  variables  are  mandatory.  In  addition,  the  following  input 
variables  are  required  under  the  specified  circumstances: 


Item 

Rough  sIodc  runup 

Svmbol 

Source 

Empirical  coefficient 

a 

See  Table  A-3  of  Appendix  A 

Empirical  coefficient 

b 

for  suggested  values. 

OvertooDing 

Empirical  coefficient 

a 

See  Figures  7-24  to  7-34  in  the 

Empirical  coefficient 

<2*o 

SPM  (1984). 

Item 

Symbol 

Units 

Data  Ranee 

Onshore  wind  velocity 

U 

kn,  ft/sec 
mph,  m/sec,  kph 

0.0  to  200.0 

Wave  runup  (if  known) 

R 

ft,  m 

0.0  to  100.0 

NOTE:  For  irregular  waves,  substitute  the  following: 
Incident  significant  wave  height  (Hs)  for 

Peak  wave  period  (Tp)  for  T 
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Procedure 


Results  from  this  application  are  displayed  on  one  screen.  Those  data  include 
the  original  input  values  (in  final  units)  and  the  following  parameters: 


Item 

Svmbol 

English 

Metric 

Units 

Units 

monochromatic 

irregular 

waves 

waves 

Deepwater 

Wave  height 

Ho 

tfsO 

ft 

m 

Relative  height 

ds/HQ 

da/Hso 

Wave  steepness 

Ho/gT* 

H3o/gT* 

Runup 

i?(if  requested) 

Rs 

ft 

m 

Overtopping  rate 

<2{'f  requested) 

Q 

ft3/sec-ft 

m3/sec-m 

The  deepwater  wave  parameters  are  provided  as  an  aid  to  determining  the 
empirical  overtopping  coefficients  from  the  referenced  figures  in  the  SPM  (1984). 


The  bulleted  items  in  the  following  lists  indicate  potentially  optional  instruction 
steps.  Any  application  in  ACES  may  be  executed  in  a  given  session  without 
quitting  the  program.  The  bulleted  items  provide  instructions  for  accessing  the 
application  from  various  menu  areas  of  the  ACES  program.  Ignore  bulleted 
instruction  steps  that  are  not  applicable. 


Single  Case  Mode 

°  Press  (fi)  on  the  Main  Menu  to  select  Single  Case  Mode. 

°  Fill  in  the  highlighted  input  fields  on  the  General  Specifications  screen 
(or  leave  the  default  values).  Press  (fT)  when  all  data  on  this  screen 
are  correct. 

°  Press  (fs|  on  the  Functional  Area  Menu  to  select  Wave  Runup, 
Transmission,  and  Overtopping. 

°  Press  (F2)  on  the  Wave  Runup,  Transmission,  and  Overtopping 
Application  Menu  to  select  Wave  Runup  and  Overtopping  on 
Impermeable  Structures. 

°  On  the  Wave  Runup  and  Overtopping  on  Impermeable  Structures  Menu, 
press  one  of  the  following: 
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Selections  for  Monochromatic  Waves 

(fT|  Estimate  runup  on  rough  slope  structures. 

(F2)  Estimate  runup  on  smooth  slope  structures. 

(F3)  or  [F4]  Estimate  overtopping  rate  with  a  known  run-up  value. 

(F5)  Estimate  both  runup  and  overtopping  rate  on  rough  slope 
structures. 

[F6]  Estimate  both  runup  and  overtopping  rate  on  smooth  slope 
structures. 

Selections  for  Irregular  Waves 

(ft)  or  (fs)  Estimate  overtopping  rate  with  a  known  run-up  value. 

1.  Fill  in  the  highlighted  input  fields  on  the  Wave  Runup  and  Overtopping  on 
Impermeable  Structures  screen.  Respond  to  any  corrective  instructions 
appearing  at  the  bottom  of  the  screen.  Press  (fT)  when  all  data  on  this  screen 
are  correct. 

NOTE:  If  the  selected  case  involved  the  computation  of  rough 
slope  runup,  (fio)  may  be  pressed  to  provide  access  to  the 
additional  following  options  (choose  one): 

(fi)  Return  to  the  input  screen. 

(F2)  Display  a  table  of  suggested  rough  slope  run-up  empirical 
coefficients  ( a  and  b).  If  this  option  is  selected,  these 
coefficients  must  be  entered  in  the  designated  fields  of  the 
display  screen.  The  data  thus  given  will  be  transferred  back 
to  (and  displayed  on)  the  main  input  screen  when  (fT)  is 
pressed. 

[fio]  Exit  the  application. 

2.  All  input  and  output  data  are  displayed  on  the  screen  in  the  final  system  of 
units. 

3.  Press  one  of  the  following  keys  to  select  the  appropriate  action: 

(fT)  Return  to  Step  1  for  a  new  case. 

(F3)  Send  a  summary  of  this  case  to  the  print  file  or  device. 

[fio]  Exit  this  application  and  return  to  the  Wave  Runup, 
Transmission,  and  Overtopping  Menu. 
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Multiple  Case  Mode 

Run-up  values  are  provided  in  this  operational  mode,  but  overtopping  rates  are 
excluded  because  of  possible  functional  dependencies  between  incident  wave 
conditions,  structure  slope,  and  the  empirical  overtopping  coefficients.  Single 
Case  or  Batch  Modes  may  be  used  to  process  cases  providing  overtopping  rates. 


0  Press  (F2]  on  the  Main  Menu  to  select  Multi  Case  Mode. 

°  Fill  in  the  highlighted  input  fields  on  the  General  Specifications  screen 
(or  leave  the  default  values).  Press  (fT|  when  all  data  on  this  screen 
are  correct. 

0  Press  (fs)  on  the  Functional  Area  Menu  to  select  Wave  Runup, 
Transmission,  and  Overtopping. 

°  Press  (F2)  on  the  Wave  Runup,  Transmission,  and  Overtopping 
Application  Menu  to  select  Wave  Runup  and  Overtopping  on 
Impermeable  Structures. 

°  On  the  Wave  Runup  and  Overtopping  on  Impermeable  Structures  Menu, 
press  one  of  the  following: 

[Fl)  Estimate  runup  on  rough  slope  structures. 

NOTE:  Selection  of  this  option  will  display  the 
table  of  suggested  rough  slope  run-up  empirical 
coefficients  ( a  and  b).  Fill  in  the  highlighted  input 
fields  with  the  values  for  these  items,  and  press 
(fT)  to  resume  input  on  the  main  input  screen,  or 
press  [fio)  to  exit  the  application. 

(F2)  Estimate  runup  on  smooth  slope  structures. 

1.  Move  the  cursor  to  select  a  variable  on  the  Wave  Runup  and  Overtopping 
on  Impermeable  Structures  screen  (the  selected  variable  name  blinks).  The 
current  set  of  values  for  the  variable  is  displayed  on  the  right  portion  of  the 
screen.  When  all  variable  sets  are  correct,  go  to  Step  3. 

2.  Enter  a  set  of  values  for  the  subject  variable  by  following  one  of  the  input 
methods: 

a.  Press  ®  to  select  random  method.  Enter  up  to  20  values  constituting 
a  set  for  this  variable  (one  in  each  field)  on  the  right  side  of  the  screen. 
The  set  of  20  values  originally  displayed  (first  execution)  in  these  fields 
contains  the  "delimiting"  value,  which  "delimits"  or  "ends"  the  set.  The 
"delimiting"  value  is  not  included  as  a  member  in  the  set  unless  it  is 
the  sole  member. 
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b.  Press  ®  to  select  incremental  method.  Fill  in  the  fields  for  minimum, 
maximum,  and  increment  values  for  this  variable  on  the  right  side  of 
the  screen.  In  this  method,  the  members  of  the  set  include  all  values 
from  the  minimum  to  the  maximum  (both  inclusive)  at  the  specified 
increment. 

The  units  field  should  also  be  specified  for  the  variable  regardless  of  input 
method.  All  members  of  a  set  of  values  for  a  subject  variable  are  assigned 
the  specified  units.  When  all  data  are  correct  for  the  subject  variable,  press 
[Fio]  to  return  to  Step  1.  Errors  are  reported  at  the  bottom  of  the  screen 
and  are  corrected  by  pressing  (Fl)  to  allow  respecification  of  the  data  for  the 
subject  variable. 


3.  Press  (fT)  to  process  the  cases  resulting  from  the  combinations  of  the  sets  of 
data  for  all  variables.  The  summary  of  each  case  will  be  sent  to  the  print 
file  or  device.  The  screen  will  display  the  total  number  of  cases  to  be 
processed  as  well  as  report  progress.  Errors  are  reported  at  the  bottom  of 
the  screen  and  are  corrected  by  pressing  (fT|  to  allow  respecification  of 
variable  sets. 

4.  Press  one  of  the  following  keys  to  select  the  appropriate  action: 


|Fp  Return  to  Step  1  to  specify  new  sets. 

[fio]  Exit  this  application  and  return  to  the  Wave  Runup, 
Transmission,  and  Overtopping  Menu. 
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Example  Problems 

Example  1  -  Monochromatic  Wave  -  Rough  Slope  Runup  (Riprap) 


Input 

Item 

Svmbol 

Vahie 

Units 

Incident  wave  height 

Hi 

7.50 

ft 

Wave  period 

T 

10.00 

sec 

Cotan  of  nearshore  slope 

cot 

100.00 

Water  depth  at  structure  toe 

ds 

12.50 

ft 

Cotan  of  structure  slope 

cot  0 

3.00 

Structure  height  above  toe 

K 

20.00 

ft 

Roueh  slope  run-uD  item 

Empirical  coefficient 

a 

0.956 

Empirical-  coefficient 

b 

0.398 

Output 

Item 

Svmbol 

Value 

Units 

Deep  water 

Wave  height 

H0 

6.386 

ft 

Relative  height 

ds/H0 

1.957 

Wave  steepness 

Ho/ ST2 

0.002 

Runup 

R 

9.421 

ft 
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Example  2  -  Monochromatic  Wave  -  Smooth  Slope  Runup 


Input 


Item 

Svmbol 

Value 

Units 

Incident  wave  height 

Hi 

7.50 

ft 

Wave  period 

T 

10.00 

sec 

Cotan  of  nearshore  slope 

cot  4> 

100.00 

Water  depth  at  structure  toe 

dB 

12.50 

ft 

Cotan  of  structure  slope 

cot  0 

3.00 

Structure  height  above  toe 

hs 

20.00 

ft 

Output 


Item 

Deep  water 

Svmbol 

Value 

Units 

Wave  height 

H0 

6.386 

ft 

Relative  height 

de/H0 

1.957 

Wave  steepness 

H0/gT* 

0.002 

Runup 

R 

21.366 

ft 
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Example  3  -  Monochromatic  Wave  -  Rough  Slope  Overtopping 


Input 


Item 

Svmbol 

Value 

Units 

Incident  wave  height 

H i 

7.50 

ft 

Wave  period 

T 

10.00 

sec 

Cotan  of  nearshore  slope 

cot  <j> 

100.00 

Water  depth  at  structure  toe 

dB 

12.50 

ft 

Cotan  of  structure  slope 

cot  9 

3.00 

Structure  height  above  toe 

K 

20.00 

ft 

Overtopping  item 


Empirical  coefficient 
(computed) 

a 

0.076463 

Empirical  coefficient 

0*o 

0.025 

Onshore  wind  velocity 

u 

35.000 

kn 

Wave  runup  (if  known) 

R 

15.000 

ft 

Output 

Item 

Svmbol 

Value 

Units 

Deep  water 

Wave  height 

hq 

6.386 

ft 

Relative  height 

ds/H0 

1.957 

Wave  steepness 

H0/gT 2 

0.001985 

Overtopping  rate 

0 

3.565 

ft3/sec-ft 
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Example  4  -  Monochromatic  Wave  -  Smooth  Slope  Overtopping 


Input 


Item 

Svmbol 

Value 

Units 

Incident  wave  height 

7.50 

ft 

Wave  period 

T 

10.00 

sec 

Cotan  of  nearshore  slope 

cot 

100.00 

Water  depth  at  structure  toe 

ds 

12.50 

ft 

Cotan  of  structure  slope 

cot  0 

3.00 

Structure  height  above  toe 

K 

20.00 

ft 

OvertODoins  item 

Empirical  coefficient 

a 

0.076463 

(computed) 

Empirical  coefficient 

Q*  o 

0.025 

Onshore  wind  velocity 

u 

35.000 

kn 

Wave  runup  (if  known) 

R 

20.000 

ft 

Output 

Item 

Svmbol 

Value 

Units 

Deep  water 

Wave  height 

#0 

6.386 

ft 

Relative  height 

ds/H0 

1.957 

Wave  steepness 

H0/gT 2 

0.001985 

Overtopping  rate 

Q 

5.368 

ft3/sec- 
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Example  5  -  Monochromatic  Wave  -  Rough  Slope  Runup  and  Overtopping 
(Riprap) 

Input 


Item 

Svmbol 

Value 

Units 

Incident  wave  height 

Hi 

7.50 

ft 

Wave  period 

T 

10.00 

sec 

Cotan  of  nearshore  slope 

cot  4> 

100.00 

Water  depth  at  structure  toe 

d* 

12.50 

ft 

Cotan  of  structure  slope 

cot  © 

3.00 

Structure  height  above  toe 

K 

20.00 

ft 

Roush  slope  run-up  item 

Empirical  coefficient 

a 

0.956 

Empirical  coefficient 

b 

0.398 

Overtopping  item 

Empirical  coefficient 
(computed) 

a 

0.076463 

Empirical  coefficient 

Q\ 

0.025 

Onshore  wind  velocity 

u 

35.000 

kn 

Output 

Item 

Svmbol 

Value 

Units 

Deep  water 

Wave  height 

Ho 

6.386 

ft 

Relative  height 

da/H0 

1.957 

Wave  steepness 

Ho/gT 2 

0.001985 

Runup 

R 

9.421 

ft 

Overtopping  rate 

Q 

0.829 

ft3/sec- 
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Example  6  -  Monochromatic  Wave  -  Smooth  Slope  Runup  and  Overtopping 


Input 


Item 

Svmbol 

Value 

Units 

Incident  wave  height 

Hi 

7.50 

ft 

Wave  period 

T 

10.00 

sec 

Cotan  of  nearshore  slope 

cot  <\> 

100.00 

Water  depth  at  structure  toe 

dB 

12.50 

ft 

Cotan  of  structure  slope 

cot  0 

3.00 

Structure  height  above  toe 

K 

20.00 

ft 

OvertoDDine  item 

Empirical  coefficient 

a 

0.076463 

(computed) 

Empirical  coefficient 

Q\ 

0.025 

Onshore  wind  velocity 

u 

35.000 

kn 

Output 

Item 

Svmbol 

Value 

Units 

Deep  water 

Wave  height 

H0 

6.386 

ft 

Relative  height 

ds/H0 

1.957 

Wave  steepness 

Ho/gT* 

0.001985 

Runup 

R 

21.366 

ft 

Overtopping  rate 

Q 

5.771 

ft3/sec- 
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Example  7  -  Irregular  Wave  -  Rough  Slope  Runup  and  Overtopping  (Riprap) 
Input 


Item 

Svmbol 

Value 

Units 

Incident  wave  height 

He 

7.50 

ft 

Wave  period 

T 

10.00 

sec 

Cotan  of  nearshore  slope 

cot  <j> 

100.00 

Water  depth  at  structure  toe 

da 

12.50 

ft 

Cotan  of  structure  slope 

cot  © 

3.00 

Structure  height  above  toe 

K 

20.00 

ft 

Rough  slooe  run-uo  item 

Empirical  coefficient 

a 

0.956 

Empirical  coefficient 

b 

0.398 

OvertODDing  item 

Empirical  coefficient 
(computed) 

a 

0.076463 

Empirical  coefficient 

Q\ 

0.025 

Onshore  wind  velocity 

u 

35.000 

kn 

Output 

Item 

Svmbol 

Value 

Units 

Deep  water 

Wave  height 

//so 

6.386 

ft 

Relative  height 

dB/Hs0 

1.957 

Wave  steepness 

Hso/gT2 

0.001985 

Runup 

Rs 

9.421 

ft 

Overtopping  rate 

Q 

0.287 

ft3/sec- 
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Example  8  -  Irregular  Wave  - 

Smooth  Slope  Runup  and  Overtopping 

Input 

Item 

Symbol 

Value 

Units 

Incident  wave  height 

ffs 

7.50 

ft 

Wave  period  ■ 

T 

10.00 

sec 

Co  tan  of  nearshore  slope 

cot 

100.00 

Water  depth  at  structure  toe 

d a 

12.50 

ft 

Cotan  of  structure  slope 

cot  0 

3.00 

Structure  height  above  toe 

K 

20.00 

ft 

OvertooDine  item 

Empirical  coefficient 
(computed) 

a 

0.076463 

Empirical  coefficient 

<2*o 

0.025 

Onshore  wind  velocity 

u 

35.000 

kn 

Output 

Item 

Symbol 

Value 

Units 

Deep  water 

Wave  height 

tfsO 

6.386 

ft 

Relative  height 

ds/H0 

1.957 

Wave  steepness 

Hso/gT 2 

0.001985 

Runup 

*s 

21.366 

ft 

Overtopping  rate 

Q 

2.728 

ft3/s-f 
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Description 

This  application  provides  estimates  of  wave  runup  and  transmission  on  rough 
and  smooth  slope  structures.  It  also  addresses  wave  transmission  over  impermeable 
vertical  walls  and  composite  structures.  In  all  cases,  monochromatic  waves  are 
specified  at  the  toe  of  a  structure  that  is  assumed  to  be  impermeable.  For  sloped 
structures,  a  method  suggested  by  Ahrens  and  Titus  (1985)  and  Ahrens  and  Burke 
(1987)  is  used  to  predict  runup,  while  the  method  of  Cross  and  Sollitt  (1971)  as 
modified  by  Seelig  (1980)  is  used  to  predict  overtopping.  For  vertical  wall  and 
composite  structures,  a  method  proposed  by  Goda,  Takeda,  and  Moriya  (1967) 
and  Goda  (1969)  is  used  to  predict  wave  transmission. 


Input 

The  terminology  used  to  define  wave  transmission  on  impermeable  structures  is 
shown  in  Figures  5-3-1  and  5-3-2. 


Figure  5-3  2 .  Composite  Structure  with  Vertical  Wall 
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AIL  data  input  for  this  application  is  done  on  one  screen.  The  following  list 
describes  the  necessary  input  parameters  with  their  corresponding  units  and  range 
of  data  recognized  by  this  application: 


Mandatory  item 

Symbol 

Units 

Data 

Range 

Incident  wave  height 

H i 

ft,  m 

0.1 

to 

100.0 

Wave  period 

T 

sec 

1.0 

to 

1000.0 

Cotan  of  nearshore  slope 

cot  $ 

5.0 

to 

10000.0 

Water  depth  at  structure 

ds 

ft,  m 

0.1 

to 

200.0 

toe 

Structure  height  above  toe 

K 

ft,  m 

0.0 

to 

200.0 

Structure  crest  width 

B 

ft,  m 

0.0 

to 

200.0 

The  above  input  variables 

are  mandatory. 

In  addition. 

the  following  input 

variables  are  required  under  the  specified  circumstances: 

Item 

Symbol 

Units 

Data  Range 

Rough  and  smooth  slope 

Cotan  of  structure  slope 

cot  O 

0.0 

to 

30.0 

Runup  (if  known) 

R 

ft,  m 

0.0 

to 

100.0 

Item 

Rough  slope  runup 
Empirical  coefficient 
Empirical  coefficient 


Symbol  Source 

a  Sec  Table  A-3  of  Appendix  A 

b  for  suggested  values. 


Item  Symbol  Units  Data  Range 

Vertical  wall 

Toe  protection  or  hh  ft,  m  0.0  to  200.0 

composite  breakwater 
berm  height  above 
structure  toe  (if 
present) 


Output 

Results  from  this  application  are  displayed  on  one  screen.  Those  data  include 
the  original  input  values  (in  final  units)  and  the  following  parameters: 
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Procedure 


Item 

Symbol 

English 

Units 

Metric 

Units 

Wave  runup  (if  requested) 

R 

ft 

m 

Transmitted  wave  height 

Ht 

ft 

m 

The  bulleted  items  in  the  following  lists  indicate  potentially  optional  instruction 
steps.  Any  application  in  ACES  may  be  executed  in  a  given  session  without 
quitting  the  program.  The  bulleted  items  provide  instructions  for  accessing  the 
application  from  various  menu  areas  of  the  ACES  program.  Ignore  bulleted 
instruction  steps  that  are  not  applicable. 


Single  Case  Mode 

°  Press  (fi)  on  the  Main  Menu  to  select  Single  Case  Mode. 

°  Fill  in  the  highlighted  input  fields  on  the  General  Specifications  screen 
(or  leave  the  default  values).  Press  (fT)  when  all  data  on  this  screen 
are  correct. 

°  Press  (fs)  on  the  Functional  Area  Menu  to  select  Wave  Runup, 
Transmission,  and  Overtopping. 

°  Press  (F3)  on  the  Wave  Runup,  Transmission,  and  Overtopping 
Application  Menu  to  select  Wave  Transmission  on  Impermeable 
Structures. 

0  On  the  Wave  Transmission  on  Impermeable  Structures  Menu,  press  one 
of  the  following: 

(ft)  Estimate  wave  transmission  over  a  sloped  structure  (with 
a  known  run-up  value). 


Estimate  wave  transmission  over  a  vertical  wall  or 
composite  breakwater. 

Estimate  both  runup  and  wave  transmission  on  rough 
slope  structures. 


(F4)  Estimate  both  runup  and  wave  transmission  on  smooth 
slope  structures. 

I.  Fill  in  the  highlighted  input  fields  on  the  Wave  Transmission  on  Impermeable 
Structures  screen.  Respond  to  any  corrective  instructions  appearing  at  the 
bottom  of  the  screen.  Press  (ft)  when  all  data  on  this  screen  are  correct. 
NOTE:  If  the  selected  case  involved  the  computation  of  rough 
slope  runup,  [fio]  may  be  pressed  to  provide  access  to  the 
additional  following  options  (choose  one): 


Return  to  the  input  screen. 
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(F2]  Display  a  table  of  suggested  rough  slope  run-up  empirical 
coefficients  (a  and  b).  If  this  option  is  selected,  these 
coefficients  must  be  entered  in  the  designated  fields  of 
the  display  screen.  The  data  thus  given  will  be  transferred 
back  to  (and  displayed  on)  the  main  input  screen  when 
(fT)  is  pressed. 

(fio)  Exit  the  application. 

2.  All  input  and  output  data  are  displayed  on  the  screen  in  the  final  system  of 
units. 

3.  Press  on£  of  the  following  keys  to  select  the  appropriate  action: 

(FI)  Return  to  Step  1  for  a  new  case. 

(F3)  Send  a  summary  of  this  case  to  the  print  file  or  device, 

(fio)  Exit  this  application  and  return  to  the  Wave  Runup, 

Transmission,  and  Overtopping  Menu. 

Multiple  Case  Mode 

Run-up  values  and  the  associated  transmitted  wave  heights  over  sloped  structures 
are  provided  in  this  operational  mode.  Also,  wave  transmission  over  vertical 
walls  and  composite  structures  is  handled.  Wave  transmission  with  known  run-up 
values  on  sloped  structures  is  excluded  because  of  possible  functional 
dependencies  between  given  incident  wave  conditions,  structure  slope,  and  run-up 
values.  Single  Case  or  Batch  Modes  may  be  used  to  process  cases  providing  wave 
transmission  with  known  run-up  values. 

°  Press  [F2)  on  the  Main  Menu  to  select  Multi  Case  Mode. 

°  Fill  in  the  highlighted  input  fields  on  the  General  Specifications  screen 
(or  leave  the  default  values).  Press  @  when  all  data  on  this  screen 
are  correct. 

0  Press  [fs]  on  the  Functional  Area  Menu  to  select  Wave  Runup, 
Transmission,  and  Overtopping. 

Press  (fs)  on  the  Wave  Runup,  Transmission,  and  Overtopping 
Application  Menu  to  select  Wave  Transmission  on  Impermeable 
Structures. 

0  On  the  Wave  Transmission  on  Impermeable  Structures  Menu,  press  one 
of  the  following: 

Estimate  wave  transmission  over  vertical  walls  or 
composite  structures. 

Estimate  runup  and  wave  transmission  on  rough  slope 
structures. 
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NOTE:  Selection  of  this  option  will  display  the 
table  of  suggested  rough  slope  run-up  empirical 
coefficients  ( a  and  b).  Fill  in  the  highlighted  input 
fields  with  the  values  for  these  items,  and  press 
(fT)  to  resume  input  on  the  main  input  screen,  or 
press  [fio]  to  exit  the  application. 

(f4)  Estimate  runup  and  wave  transmission  on  smooth  slope 
structures. 

1 .  Move  the  cursor  to  select  a  variable  on  the  Wave  T ransmission  on  Impermeable 
Structures  screen  (the  selected  variable  name  blinks).  The  current  set  of 
values  for  the  variable  is  displayed  on  the  right  portion  of  the  screen.  When 
all  variable  sets  are  correct,  go  to  Step  3. 

2.  Enter  a  set  of  values  for  the  subject  variable  by  following  one  of  the  input 
methods: 

a.  Press  ®  to  select  random  method.  Enter  up  to  20  values  constituting 
a  set  for  this  variable  (one  in  each  field)  on  the  right  side  of  the  screen. 
The  set  of  20  values  originally  displayed  (first  execution)  in  these  fields 
contains  the  "delimiting"  value,  which  "delimits"  or  "ends"  the  set.  The 
"delimiting"  value  is  not  included  as  a  member  in  the  set  unless  it  is 
the  sole  member. 

b.  Press  (T)  to  select  incremental  method.  Fill  in  the  fields  for  minimum, 
maximum,  and  increment  values  for  this  variable  on  the  right  side  of 
the  screen.  In  this  method,  the  members  of  the  set  include  all  values 
from  the  minimum  to  the  maximum  (both  inclusive)  at  the  specified 
increment. 

The  units  field  should  also  be  specified  for  the  variable  regardless  of  input 
method.  All  members  of  a  set  of  values  for  a  subject  variable  are  assigned 
the  specified  units.  When  all  data  are  correct  for  the  subject  variable,  press 
[fio)  to  return  to  Step  1.  Errors  are  reported  at  the  bottom  of  the  screen 
and  are  corrected  by  pressing  (fi)  to  allow  respecification  of  the  data  for  the 
subject  variable. 

3.  Press  (fi)  to  process  the  cases  resulting  from  the  combinations  of  the  sets  of 
data  for  all  variables.  The  summary  of  each  case  will  be  sent  to  the  print 
file  or  device.  The  screen  will  display  the  total  number  of  cases  to  be 
processed  as  well  as  report  progress.  Errors  are  reported  at  the  bottom  of 
the  screen  and  are  corrected  by  pressing  @  to  allow  respecification  of 
variable  sets. 

4.  Press  one  of  the  following  keys  to  select  the  appropriate  action: 

(fT)  Return  to  Step  1  to  specify  new  sets. 

[Fioj  Exit  this  application  and  return  to  the  Wave  Runup, 
Transmission,  and  Overtopping  Menu. 
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Example  Problems 


Example  1  -  Sloped  Structure  - 

Known  Runup 

-  Transmission  Only 

Input 

Item 

Svmbol 

Value 

Units 

Incident  wave  height 

Hi 

7.50 

ft 

Wave  period 

T 

10.00 

sec 

Cotan  of  nearshore  slope 

cot  4> 

100.00 

Water  depth  at  structure  toe 

d s 

10.00 

ft 

Cotan  of  structure  slope 

cot  0 

3.00 

Structure  height  above  toe 

K 

15.00 

ft 

Structure  crest  width 

B 

7.50 

ft 

Known  runup 

R 

15.00 

ft 

Output 

Item 

Svmbol 

Value 

Units 

Transmitted  wave  height 

Ht 

2.275 

ft 

Example  2  -  Vertical  Wall  with  Berm  (Submerged) 

-  Transmission  Only 

Input 

Item 

Svmbol 

Value 

Units 

Incident  wave  height 

Hi 

7.50 

ft 

Wave  period 

T 

4.50 

sec 

Cotan  of  nearshore  slope 

cot  <)> 

100.00 

Water  depth  at  structure  toe 

ds 

20.00 

ft 

Structure  height  above  toe 

K 

17.50 

ft 

Structure  crest  width 

B 

12.00 

ft 

Structure  berm  height  above  toe 

hh 

6.00 

ft 

Output 

Item 

Svmbol 

Value 

Units 

Transmitted  wave  height 

Hr 

3.798 

ft 
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Example  3  -  Rough  Slope  - 

Runup  and  Transmission 

(Riprap) 

Input 

Item 

Svmbol 

Value 

Units 

Incident  wave  height 

Hi 

7.50 

ft 

Wave  period 

T 

10.00 

sec 

Cotan  of  nearshore  slope 

cot  <{> 

100.00 

Water  depth  at  structure  toe 

ds 

10.00 

ft 

Cotan  of  structure  slope 

cot  0 

3.00 

Structure  height  above  toe 

K 

15.00 

ft 

Structure  crest  width 

B 

7.50 

ft 

Empirical  coefficient 

a 

0.956 

Empirical  coefficient 

b 

0.398 

Output 

■ 

Item 

Svmbol 

Value 

Units 

Wave  runup 

R 

9.421 

ft 

Transmitted  wave  height 

Hr 

1.601 

ft 

Example  4  -  Smooth  Slope  -  Runup  and  Transmission 


Input 

Item 

Svmbol 

Value 

Units 

Incident  wave  height 

Hi 

7.50 

ft 

Wave  period 

T 

10.00 

sec 

Cotan  of  nearshore  slope 

cot  4> 

100.00 

Water  depth  at  structure  toe 

ds 

10.00 

ft 

Cotan  of  structure  slope 

cot  0 

3.00 

Structure  height  above  toe 

K 

15.00 

ft 

Structure  crest  width 

B 

7.50 

ft 

Output 

Item 

Svmbol 

Value 

Units 

Wave  runup 

R 

22.436 

ft 

Transmitted  wave  height 

Ht 

2.652 

ft 
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Description 


Porous  rubble-mound  structures  consisting  of  quarry  stones  of  various  sizes  often 
offer  an  attractive  solution  to  the  problem  of  protecting  a  harbor  against  wave 
action.  It  is  important  to  assess  the  effectiveness  of  a  given  breakwater  design 
by  predicting  the  amount  of  wave  energy  transmitted  by  the  structure.  This 
application  determines  wave  transmission  coefficients  and  transmitted  wave 
heights  for  permeable  breakwaters  with  crest  elevations  at  or  above  the  still-water 
level.  This  application  can  be  used  with  breakwaters  armored  with  stone  or 
artificial  armor  units.  The  application  uses  a  method  developed  for  predicting 
wave  transmission  by  overtopping  coefficients  using  the  ratio  of  breakwater 
freeboard  to  wave  runup  (suggested  by  Cross  and  Sollitt,  1971).  The  wave 
transmission  by  overtopping  prediction  method  is  then  combined  with  the  model 
of  wave  reflection  and  wave  transmission  through  permeable  structures  of  Madsen 
and  White  (1976).  Seelig  (1979,1980)  had  developed  a  similar  version  for 
mainframe  processors. 


Input 


All  data  input  for  this  application  is  done  on  two  screens.  For  each  screen  the 
necessary  input  parameters  with  their  corresponding  units  and  range  of  data 
recognized  by  this  application  are  given  below. 


First  Screen 

Item  Symbol 

Incident  wave  height  //; 

Wave  period  T 

Water  depth  at  structure  ds 

Number  of  materials  NM 

comprising  the 
breakwater 


Units 

Data  Range 

ft,  m 

0.1 

to 

100.0 

sec 

1.0 

to 

1000.0 

ft,  m 

0.1 

to 

200.0 

1 

to 

4 
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Mean  diameter  of  each  c/50  ft,  m  0.05  to  99.0 

material 

NOTE:  Determine  the  mean  diameter  of  a  given  material  using 
the  following  relation: 

where:  t/50  =  median  weight 

y  =  specific  weight 

P  %  See  Table  A-2,  Appendix  A 


Porosity  of  each  material 


Second  Screen  (Breakwater  Geometry  Input) 


Item 

Symbol 

Units 

Data  Range 

Units 

ft,  m 

Structure  height  above  toe 

K 

ft,  m 

0.1 

to 

200.0 

Cotangent  of  structure 
slope 

cot  0 

1.0 

to 

5.0 

Structure  crest  width 

B 

ft,  m 

0.1 

to 

200.0 

Number  of  horizontal 

layers  in  the  breakwater 

NL 

1 

to 

4 

NOTE:  Divide  the  breakwater  into  horizontal  layers.  A  new  layer 
occurs  any  time  there  is  a  change  vertically  in  any  material  type. 
Make  the  layer  next  to  the  seabed  layer  number  1  and  proceed 
upward. 


Thickness  of  each 
horizontal  layer 

TH 

ft,  m 

0.1 

to 

200.0 

Horizontal  length  of  each 

LL 

ft,  m 

0.0 

to 

200.0 

material  in  each  layer 

NOTE:  Determine  an  average  horizontal  length  of  each  material 
in  each  layer.  This  average  length  is  measured  at  the  midpoint 
of  each  layer.  Remove  the  outer  layer  of  armor  from  the  seaward 
face  of  the  breakwater  before  making  length  calculations,  because 
the  energy  dissipation  on  the  front  face  is  determined  separately. 
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Output 


Results  from  this  application  are  displayed  on  one  screen.  Those  data  include 
the  original  input  values  (in  final  units)  and  the  following  parameters: 

Item 

Svmbol 

English  Metric 

Units  Units 

Wave  reflection  coefficient 

Kr 

Wave  transmission  coefficients 
Through 

KTt 

Overtopping 

KTo 

Total 

kt 

Transmitted  wave  height 

H x 

ft  m 

Procedure 


The  bulleted  items  in  the  following  lists  indicate  potentially  optional  instruction 
steps.  Any  application  in  ACES  may  be  executed  in  a  given  session  without 
quitting  the  program.  The  bulleted  items  provide  instructions  for  accessing  the 
application  from  various  menu  areas  of  the  ACES  program.  Ignore  bulleted 
instruction  steps  that  are  not  applicable. 


Single  Case  Mode 


°  Press  (fi)  on  the  Main  Menu  to  select  Single  Case  Mode. 

0  Fill  in  the  highlighted  input  fields  on  the  General  Specifications  screen 
(or  leave  the  default  values).  Press  (fi)  when  all  data  on  this  screen 
are  correct. 

°  Press  (fs)  on  the  Functional  Area  Menu  to  select  Wave  Runup, 
Transmission,  and  Overtopping. 

°  Press  (F4|  on  the  Wave  Runup,  Transmission,  and  Overtopping  Menu 
to  select  Wave  Transmission  Through  Permeable  Structures. 
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1.  Fill  in  the  highlighted  input  fields  on  the  first  screen;  then  press  (fT)  to  obtain 
the  second  screen  in  this  application,  and  fill  in  the  input  fields.  Respond 
to  any  corrective  instructions  appearing  at  the  bottom  of  the  screens.  Press 
(fT)  when  all  data  on  this  second  screen  are  correct. 

2.  All  output  data  and  selected  input  data  are  displayed  on  the  screen  in  the 
final  system  of  units. 

3.  Press  one  of  the  following  keys  to  select  the  appropriate  action: 

(fi)  Return  to  Step  1  for  a  new  case. 

[F3|  Send  a  summary  of  this  case  to  the  print  file  or  device. 

[Fio]  Exit  this  application  and  return  to  the  Wave  Runup, 
Transmission,  and  Overtopping  Menu. 


Multiple  Case  Mode 


0  Press  (F2]  on  the  Main  Menu  to  select  Multi  Case  Mode. 

°  Fill  in  the  highlighted  input  fields  on  the  General  Specifications  screen 
(or  leave  the  default  values).  Press  (fT)  when  all  data  on  this  screen 
are  correct. 

0  Press  (fs)  on  the  Functional  Area  Menu  to  select  Wave  Runup, 
Transmission,  and  Overtopping. 

°  Press  [F4]  on  the  Wave  Runup,  Transmission,  and  Overtopping  Menu 
to  select  Wave  Transmission  Through  Permeable  Structures. 

1.  Fill  in  the  highlighted  input  fields  on  the  first  screen;  then  press  (Fl)  to  obtain 
the  second  screen  in  this  application,  and  fill  in  the  input  fields.  Respond 
to  any  corrective  instructions  appearing  at  the  bottom  of  the  screen.  Press 
(fi)  when  all  data  on  this  second  screen  are  correct  to  obtain  the  third  data 
input  screen. 

2.  Move  the  cursor  to  select  the  wave  height  or  wave  period  variable  on  this 
screen  (the  selected  variable  name  blinks).  The  current  set  of  values  for  the 
variable  is  displayed  on  the  right  portion  of  the  screen.  When  all  variable 
sets  are  correct,  go  to  Step  4. 
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3.  Enter  a  set  of  values  for  the  subject  variable  by  following  one  of  the  input 
methods: 

a.  Press  ®  to  select  random  method.  Enter  up  to  20  values  constituting 
a  set  for  this  variable  tone  in  each  field)  on  the  right  side  of  the  screen. 
The  set  of  20  values  originally  displayed  (first  execution)  in  these  fields 
contains  the  "delimiting"  value,  which  "delimits"  or  "ends"  the  set.  The 
"delimiting"  value  is  not  included  as  a  member  in  the  set  unless  it  is 
the  sole  member. 

b.  Press  (7)  to  select  incremental  method.  Fill  in  the  fields  for  minimum, 
maximum,  and  increment  values  for  this  variable  on  the  right  side  of 
the  screen.  In  this  method,  the  members  of  the  set  include  all  values 
from  the  minimum  to  the  maximum  (both  inclusive)  at  the  specified 
increment. 

The  units  field  should  also  be  specified  for  the  variable  regardless  of  input 
method.  All  members  of  a  set  of  values  for  a  subject  variable  are  assigned 
the  specified  units.  When  all  data  are  correct  for  the  subject  variable,  press 
(fio)  to  return  to  Step  1 .  Errors  are  reported  at  the  bottom  of  the  screen 
and  are  corrected  by  pressing  (fi)  to  allow  respecification  of  the  data  for  the 
subject  variable. 

4.  Press  (fT)  to  process  the  cases  resulting  from  the  combinations  of  the  sets  of 
data  for  all  variables.  The  summary  of  each  case  will  be  sent  to  the  print 
file  or  device.  The  screen  will  display  the  total  number  of  cases  to  be 
processed  as  well  as  report  progress.  Errors  are  reported  at  the  bottom  of 
the  screen  and  are  corrected  by  pressing  (fi)  to  allow  respecification  of 
variable  sets. 

5.  Press  one  of  the  following  keys  to  select  the  appropriate  action: 


(fi)  Return  to  Step  1  to  specify  new  sets. 

[fio]  Exit  this  application  and  return  to- the  Wave  Runup, 
Transmission,  and  Overtopping  Menu. 
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Example  Problems 

Example  1  -  Breakwater  (3  Materials  and  3  Layers) 


Input 

All  data  input  for  this  application  is  done  on  two  screens.  For  each  screen  the 
values  and  corresponding  units  selected  for  this  first  example  problem  are  shown 
below. 


First  Screen 


Item 

Svmbol 

Value 

Units 

Wave  Characteristics 

Incident  wave  height 

6.56 

ft 

Wave  period 

T 

20.00 

sec 

Water  depth  at  structure 

da 

15.75 

ft 

Item 

Svmbol 

Value 

Material  Characteristics 

Number  of  materials  comprising  the  breakwater 

NM 

3 

Units 

ft 

Mean  diameter  of  material  1  -Armor 

^50 

2.39 

Mean  diameter  of  material  2-Underlayer 

1.11 

Mean  diameter  of  material  3-Core 

0.30 

Porosity  of  material  1 

P 

37% 

Porosity  of  material  2 

37% 

Porosity  of  material  3 

37% 

Second  Screen  (Breakwater  Geometry  Input) 

See  Figure  5-4-1  for  the  breakwater  dimensions  used  in  this  first  example. 


Item 

Svmbol 

Value 

Units 

ft 

Structure  height  above  toe 

K 

19.69 

Cotangent  of  structure  slope 

cot  0 

1.5 

Structure  crest  width 

B 

8.27 

Number  of  horizontal  layers  in  the  breakwater 

NL 

3 

5-4-6 


Wave  Transmission  Through  Permeable  Structures 


Wave  Runup,  Transmission,  and  Overtopping 


ACES  User’s  Guide 


Thickness  of  layer  1  THr  1 1 .65 

Thickness  of  layer  2  TH%  2.56 

Thickness  of  layer  3  77/s  1 .54 

Note:  Sum  of  the  layer  thicknesses  must  =  the  water  depth. 


Length  of  material  1 

in 

layer 

1 

£^i,i 

1  4.76(0.84+  4.92) 

Length  of  material  1 

in 

layer 

2 

LLi2 

14.76(6,84+4.92) 

Length  of  material  1 

in 

layer 

3 

££>1,3 

17.39 

Length  of  material  2 

in 

layer 

1 

zx2il 

12.46(8.23+8.23) 

Length  of  material  2 

in 

layer 

2 

LL2(2 

8.20 

Length  of  material  2 

in 

layer 

3 

LLZ'S 

0.0 

Length  of  material  3 

in 

layer 

1 

LL3l 

21.00 

Length  of  material  3 

in 

layer 

2 

£^3,2 

0.0 

Length  of  material  3 

in 

layer 

3 

0.0 

Figure  5-4-1.  Sample  Problem  1  -  Breakwater  Geometry 


Output 


Item 

Svmbol 

Value 

Unit; 

Wave  reflection  coefficient 

Wave  transmission  coefficients 

% 

0.719 

Through 

^Tt 

0.077 

Overtopping 

*  To 

0.227 

Total 

0.239 

Transmitted  wave  height 

ht 

1.570 

ft 

Wave  Transmission  Through  Permeable  Structures 


5 


ACES  User's  Guide 


Wave  Runup,  Transmission,  and  Overtopping 


Example  2  -  Breakwater  (3  Materials  and  4  Layers) 


Input 

All  data  input  for  this  application  is  done  on  two  screens.  For  each  screen  the 
values  and  corresponding  units  selected  for  this  second  example  problem  are 
shown  below. 


First  Screen 


Item 

SymbPl 

Value 

Units 

Wave  Characteristics 

Incident  wave  height 

Hi 

10 

ft 

Wave  period 

T 

15.00 

sec 

Water  depth  at  structure 

d* 

25.00 

ft 

Item 

Symbol 

Value 

Material  Characteristics 

Number  of  materials  comprising  the  breakwater 

NM 

3 

Units 

ft 

Mean  diameter  of  material  1 

dso 

3.61 

Armor- 16,000  lb  units  (170  lb/ft3) 
Mean  diameter  of  material  2 

Underlayer-3,000  lb  stone  (170  lb/ft3) 
Mean  diameter  of  material  3 
Core-400  lb  stone  (170  lb/ft3) 

Porosity  of  material  I 
Porosity  of  material  2 
Porosity  of  material  3 


2.07 

1.05 

37% 

37% 

37% 


Second  Screen  (Breakwater  Geometry  Input) 

See  Figure  5-4-2  for  the  breakwater  dimensions  used  in  this  second  example. 


Item 

Svmbol 

Value 

Units 

ft 

Structure  height  above  toe 

K 

38.00 

Cotangent  of  structure  slope 

COt0 

1.75 

Structure  crest  width 

B 

18.00 

Number  of  horizontal  layers  in  the  breakwater 

NL 

4 
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Thickness  of  layer  1 

THX 

4.00 

Thickness  of  layer  2 

th2 

8.00 

Thickness  of  layer  3 

th3 

7.00 

Thickness  of  layer  4 

THi 

6.00 

Note:  Sum  of  the  layer  thicknesses  must  = 

the  water  depth. 

Length  of  material  1  in  layer  1 

0 

Length  of  material  1  in  layer  2 

LL\2 

0 

Length  of  material  I  in  layer  3 

LLis 

10 

Length  of  material  1  in  layer  4 

^1.4 

28uo+ib) 

Length  of  material  2  in  layer  1 

ZX2,i 

14 

Length  of  material  2  in  layer  2 

ZjL2  2 

36 

Length  of  material  2  in  layer  3 

LL-2, 3 

46(18+30) 

Length  of  material  2  in  layer  4 

•^2,4 

32 

Length  of  material  3  in  layer  1 

LL3j 

128 

Length  of  material  3  in  layer  2 

TL3  2 

75 

Length  of  material  3  in  layer  3 

•^'■^'8,3 

22 

Length  of  material  3  in  layer  4 

LLs  ,4 

0 

NOTE:  Length  of  a  particular  material  is  measured  at  the  midpoint 
of  the  layer. 


Figure  5-4-2.  Sample  Problem  2  -  Breakwater  Geometry 

Output 


Item 

Svmbol 

Value 

Units 

Wave  reflection  coefficient 

Wave  transmission  coefficients 

Kr 

0.662 

Through 

KTt 

0.055 

Overtopping 

%Ta 

0 

Total 

Kf 

0.055 

Transmitted  wave  height 

Hr 

0.550 

ft 

Wave  Transmission  Through  Permeable  Structures 
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Description 


This  application  provides  estimates  of  the  potential  longshore  transport  rate  under 
the  action  of  waves.  The  method  used  is  based  on  the  empirical  relationship 
between  the  longshore  component  of  wave  energy  flux  entering  the  surf  zone 
and  the  immersed  weight  of  sand  moved  (Galvin,  1979).  Three  methods  are 
available  to  the  user  depending  on  whether  available  input  data  are  breaker  wave 
height  and  direction,  deepwater  wave  height  and  direction,  or  using  a  Wave 
Information  Study  hindcast  data  file  created  by  the  Coastal  Engineering  Data 
Retrieval  System  (CEDRS).  The  material  presented  herein  can  be  found  in 
Chapter  4  of  the  Shore  Protection  Manual  (1984)  and  in  Gravens  (1988). 


Input 


All  data  input  for  this  application  is  done  on  one  screen.  The  following  list 
describes  the  necessary  input  parameters  with  their  corresponding  units  and  range 
of  data  recognized  by  this  application: 


Mandatory  item 

Symbol 

Units 

Data  Ranee 

Breaking  wave  height 

Hb 

ft,  m 

0.1 

to 

100.0 

Deepwater  wave  height 

H o 

ft,  m 

0.1 

to 

100.0 

Wave  crest  angle  with 

“t, 

deg 

0.0 

to 

90.0 

shoreline 

Deepwater  angle  of  wave 

deg 

0.0 

to 

90.0 

crest 

Empirical  coefficient 

K 

0.0 

to 

1.0 

These  items  are  required  when  using 

a  CEDRS  data  file. 

For  information  on 

CEDRS  and  input  requirements  see  section  entitled  "Coastal  Engineering  Data 


Retrieval  System." 

Shore-normal  azimuth 

0 

deg 

0.0  to 

360.0 

Empirical  coefficient 

K 

0.0  to 

1.0 

External  CEDRS  file  name 

??xxx.8 10 

Longshore  Sediment  Transport 
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This  ACES  application  will  read  the  various  regional  data  files  containing  the 
percent  occurrence  statistical  data  in  the  form  of  tables  that  reside  on  the  CEDRS 
auxiliary  hard  disk.  These  data  files  have  the  following  DOS  name  convention: 


??xxx.810 

where 

??  =  coast  (see  Table  6-1-2) 
xxx  =  station  on  the  coast 


Table  6-1-2 

Coast  Designation 

?? 

Region 

a2 

Atlantic 

gl 

Gulf 

p2 

Pacific 

eO 

Lake  Erie 

hO 

Lake  Huron 

mO 

Lake  Michigan 

sO 

Lake  Superior 

oO 

Lake  Ontario 

To  use  a  particular  regional  data  file  in  this  ACES  application,  type  in  the  regional 
data  file  name  and  directory  path  name  to  the  CEDRS  directory  where  the 
regional  file  exists. 


Sediment  Transport  Direction  Convention 

For  calculation  of  potential  longshore  sand  transport  using  the  CEDRS  percent 
occurrence  data  files,  a  right-handed  coordinate  system  is  used,  in  which  waves 
approaching  normal  to  the  shoreline  are  given  an  angle  of  0  deg.  Looking 
seaward,  waves  approaching  from  the  right  are  associated  with  negative  angles, 
and  waves  approaching  from  the  left  are  associated  with  positive  angles  such 
that  positive  transport  is  directed  to  the  right.  The  shore-normal  azimuth  0  is 
measured  clockwise  from  true  north  (see  Figure  6-1-2). 
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Output 


Results  from  this  application  are  displayed  on  one  screen, 
the  original  input  values  (in  final  units)  and  the  following: 

Those  data  include 

Item 

Svmbol 

English 

Units 

Metric 

Units 

Transport  rate 

Q 

yd3/yr 

m3/yr 

When  the  CEDRS  data  file  is  used,  the  following  additional  data  are  output:  The 
wave  bands  that  approach  the  specified  shoreline;  the  wave  direction  angle 
associated  with  the  wave  band;  and  the  percentage  of  the  transport  rate  for  each 
contributing  wave  band  (see  Example  3). 
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Procedure 


The  bulleted  items  in  the  following  lists  indicate  potentially  optional  instruction 
steps.  Any  application  in  ACES  may  be  executed  in  a  given  session  without 
quitting  the  program.  The  bulleted  items  provide  instructions  for  accessing  the 
application  from  various  menu  areas  of  the  ACES  Program.  Ignore  bulleted 
instruction  steps  that  are  not  applicable. 


Single  Case  Mode 

°  Press  (fi)  on  the  Main  Menu  to  select  Single  Case  Mode. 

°  Fill  in  the  highlighted  input  fields  on  the  General  Specifications  screen 
(or  leave  the  default  values).  Press  (fT)  when  all  data  on  this  screen 
are  correct. 

°  Press  (fo)  on  the  Functional  Area  Menu  to  select  Littoral  Processes. 

0  Press  (Fi)on  the  Littoral  Processes  Application  Menu  to  select  Longshore 
Sediment  Transport. 

0  On  the  Longshore  Sediment  Transport  Menu,  press  one  of  the  following: 

[fi)  Estimate  the  transport  rate  using  deepwater  wave  conditions. 

[fp|  Estimate  the  transport  rate  using  breaking  wave  conditions. 

fF3)  Estimate  the  transport  rate  using  CEDRS  statistical  data: 
Percent  Occurrence  of  Wave  Height  &  Period  by  Direction. 
For  information  on  CEDRS  and  input  requirements  see  section 
entitled  "Coastal  Engineering  Data  Retrieval  System." 

[fio]  Exit  application 

1.  Fill  in  the  highlighted  input  fields  on  the  Longshore  Sediment  Transport 
screen.  Respond  to  any  corrective  instructions  appearing  at  the  bottom  of 
the  screen.  Press  (fT)  when  all  data  on  this  screen  are  correct. 

2.  All  input  and  output  data  are  displayed  on  the  screen  in  the  final  system  of 
units. 

3.  Press  one  of  the  following  keys  to  select  the  appropriate  action: 

Fi)  Return  to  Step  1  for  a  new  case. 

(ED  Send  a  summary  of  this  case  to  the  print  file  or  device. 
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[Flo]  Exit  this  application  and  return  to  the  Littoral  Processes 
Menu. 


Multiple  Case  Mode 

°  Press  (F2)  on  the  Main  Menu  to  select  Multi  Case  Mode. 

°  Fill  in  the  highlighted  input  fields  on  the  General  Specifications  screen 
(or  leave  the  default  values).  Press  (fT)  when  all  data  on  this  screen 
are  correct. 


°  Press  [F6|  on  the  Functional  Area  Menu  to  select  Littoral  Processes. 


0  Press  (fT)  on  the  Littoral  Processes  Application  Menu  to  select  Longshore 
Sediment  Transport. 

°  On  the  Longshore  Sediment  Transport  Menu,  press  one  of  the  following: 
(fT)  Estimate  the  transport  rate  using  deepwater  wave  conditions. 


(F2)  Estimate  the  transport  rate  using  breaking  wave  conditions. 


1.  Move  the  cursor  to  select  a  variable  on  the  Longshore  Sediment  Transport 
screen  (the  selected  variable  name  blinks).  The  current  set  of  values  for  the 
variable  is  displayed  on  the  right  portion  of  the  screen.  When  all  variable 
sets  are  correct,  go  to  Step  3. 


2.  Enter  a  set  of  values  for  the  subject  variable  by  following  one  of  the  input 
methods:. 


a.  Press  ®  to  select  random  method.  Enter  up  to  20  values  constituting 
a  set  for  this  variable  (one  in  each  field)  on  the  right  side  of  the  screen. 
The  set  of  20  values  originally  displayed  (first  execution)  in  these  fields 
contains  the  "delimiting"  value,  whi^h  "delimits"  or  "ends"  the  set.  The 
"delimiting"  value  is  not  included  as  a  member  in  the  set  unless  it  is 
the  sole  member. 

b.  Press  Q  to  select  incremental  method.  Fill  in  the  fields  for  minimum, 
maximum,  and  increment  values  for  this  variable  on  the  right  side  of 
the  screen.  In  this  method,  the  members  of  the  set  include  all  values 
from  the  minimum  to  the  maximum  (both  inclusive)  at  the  specified 
increment. 
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The  units  field  should  also  be  specified  for  the  variable  regardless  of  input 
method.  All  members  of  a  set  of  values  for  a  subject  variable  are  assigned 
the  specified  units.  When  all  data  are  correct  for  the  subject  variable,  press 
[Flo]  to  return  to  Step  I.  Errors  are  reported  at  the  bottom  of  the  screen 
and  are  corrected  by  pressing  (ft)  to  allow  respecification  of  the  data  for  the 
subject  variable. 

3.  Press  (ft)  to  process  the  cases  resulting  from  the  combinations  of  the  sets  of 
data  for  all  variables.  The  summary  of  each  case  will  be  sent  to  the  print 
file  or  device.  The  screen  will  display  the  total  number  of  cases  to  be 
processed  as  well  as  report  progress.  Errors  are  reported  at  the  bottom  of 
the  screen  and  are  corrected  by  pressing  (fi)  to  allow  respecification  of 
variable  sets. 

4.  Press  one  of  the  following  keys  to  select  the  appropriate  action: 

[fi)  Return  to  Step  1  to  specify  new  sets. 

[fio]  Exit  this  application  and  return  to  the  Littoral  Processes 
Menu. 
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Example  Problems 

Example  1  -  Deepwater  Wave  Condition 
Input 

All  data  input  for  this  application  is  done  on  one  screen.  The  values  and 
corresponding  units  selected  for  this  first  example  problem  are  shown  below. 


Item 

Svmbol 

Value 

Units 

Deepwater  wave  height 

1.75 

ft 

Deepwater  angle  of  wave  crest 

«0 

15.00 

deg 

Empirical  coefficient 

K 

0.39 

Output 

Results  from  this  application  are  displayed  on  one  screen.  Those  data  include 
the  original  input  values  and  the  following  parameter: 

Item  Symbol  Value  Units 

Transport  rate  Q  275,234  yds/yr 


Example  2  -  Breaking  Wave  Condition 
Input 

All  data  input  for  this  application  is  done  on  one  screen.  The  values  and 
corresponding  units  selected  for  this  second  example  problem  are  shown  below. 


Item 

Symbol 

Value 

Units 

Breaking  wave  height 

Hh 

3.75 

ft 

Wave  crest  angle  with  shoreline 

12.00 

deg 

Empirical  coefficient 

K 

0.39 

Output 

Results  from  this  application  are  displayed  on  one  screen.  Those  data  include 
the  original  input  values  and  the  following  parameter: 

Item  Symbol  Value  Units 

Transport  rate  Q  2,662,872  yd3/yr 
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Example  3  -  Transport  Using  CEDRS  Percent  Occurrence  Data 


Input 

All  data  input  for  this  application  is  done  on  one  screen.  The  values  and 
corresponding  units  selected  for  this  second  example  problem  are  shown  below. 


Item 

Symbol 

Value 

Units 

Shore-Normal  Azimuth 
(see  Figure  6-1-3) 

0 

40.0 

deg 

Empirical  coefficient 

K 

0.39 

External  CEDRS  File 
(see  Table  6-1-3) 

(WIS  Report  18,  pp.  C73-C77) 

G1033.810 

Output 

Results  from  this  application  are  displayed  on  one  screen.  Those  data  include 
the  original  input  values  and  the  following: 


Band 

Angle  From 

Contributing 

Transport  Rate 

Shore-Normal 

Percentage 

(cu  yd/yr) 

15 

85.00 

72.22 

9822.69 

16 

62.50 

100.00 

67924.60 

1 

40.00 

100.00 

89224.06 

2 

17.50 

100.00 

60693.54 

3 

-5.00 

100.00 

-30549.34 

4 

-27.50 

100.00 

-279184.05 

5 

-50.00 

100.00 

-556982.29 

6 

-72.5 

100.00 

-215797.42 

7 

-95.00 

27.78 

-0.56 

Total 

-854848.77 

NOTE:  Looking  seaward,  negative  transport  is  directed  to  the  left. 


6-1-10 


Longshore  Sediment  Transport 


ACES  User’s  Guide 


Littoral  Processes 


Table  6-1-3 

CEDRS  Statistical  File  for  Gulf  of  Mexico  Station  No.  33 
(File  G  1033.8 10) 

(WIS  Report  18,  pp.  C73-C77) 

PERCENT  OCCURRENCE  (X1000)  OF  HEIGHT  AND  PERIOD  BY  DIRECTION 
22.5  DEGREES  ABOUT  0.0  DEGREES  AZIMUTH 

STATION:  G1033  (29.0N,  85.5W  /  68.0M)  NO.  CASES:  1335 

%  OF  TOTAL:  2.3 


HEIGHT  PEAK  PERIOD  (IN  SECONDS) 


IN 

<4.2 

4.2- 

5.4- 

6.6- 

7.5- 

8.8- 

9.6-  10.6- 

11.9- 

13.4-  TOTAL 

METERS 

5.3 

6.5 

7.4 

8.7 

9.5  10.5 

11.8 

13.3  LONGER 

0.00-0.49 

34 

30 

5 

69 

0.50-0.99 

378 

532 

30 

940 

1.00-1.49 

780 

99 

879 

1.50-1.99 

345 

3 

348 

2.00-2.49 

42 

42 

2.50-2.99 

1 

1 

3.00-3.49 

0 

3.50-3.99 

0 

4.00-4.49 

0 

4.50-4.99 

0 

5.00+ 

0 

TOTAL 

412 

1342 

522 

3 

0 

0 

0  0 

0 

0 

MEAN  HS(M)  =  1.1  LARGEST  HS(M)  =  2.5  MEAN  TP  (SEC)  =  4.8 


PERCENT  OCCURRENCE  (X1000)  OF  HEIGHT  AND  PERIOD  BY  DIRECTION 
22.5  DEGREES  ABOUT  22.5  DEGREES  AZIMUTH 


STATION:  G1033  (29.0N,  85. 5W  /  68.0M)  NO.  CASES:  1471 

%  OF  TOTAL:  2.5 

HEIGHT  PEAK  PERIOD  (IN  SECONDS) 


IN 

<4.2 

4.2- 

5.4- 

6.6- 

7.5-  8.8-  9.6-  10.6- 

11.9- 

13.4-  TOTAL 

METERS 

5.3 

6.5 

7.4 

8.7  9.5  10.5 

11.8 

13.3  LONGER 

0.00-0.49 

66 

41 

15 

122 

0.50-0.99 

321 

602 

56 

979 

1.00-1.49 

1 

888 

104 

993 

1.50-1.99 

359 

1 

360 

2.00-2.49 

58 

58 

2.50-2.99 

0 

3.00-3.49 

0 

3.50-3.99 

0 

4.00-4.49 

* 

0 

4.50-4.99 

0 

5.00+ 

0 

TOTAL 

388 

1531 

592 

1 

0  0  0  0 

0 

0 

MEAN  HS(M)  =  1.1  LARGEST  HS(M)  -  2.4  MEAN  TP(SEC)  =  4.8 
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PERCENT  OCCURRENCE  (X1000)  OF  HEIGHT  AND  PERIOD  BY  DIRECTION 
22.5  DEGREES  ABOUT  45.0  DEGREES  AZIMUTH 


STATION:  G1033  (29.0N,  85. 5W  /  68.0M) 


NO.  CASES:  2256 
%  OF  TOTAL:  3.9 


HEIGHT 

PEAK  PERIOD  (IN  SECONDS) 

IN  <4.2 

4.2- 

5.4-  6.6-  7.5-  8.8- 

9.6-  10.6-  11.9-  13.4-  TOTAL 

METERS 

5.3 

6.5  7.4  8.7 

9.5  10.5  11.8  13.3  LONGER 

0.00-0.49 

75 

18 

23 

116 

0.50-0.99 

629 

915 

39 

1583 

1.00-1.49 

1 

1302 

135  .  . 

1438 

1.50-1.99 

592  .  . 

592 

2.00-2.49 

126 

126 

2.50-2.99 

0 

3.00-3.49 

0 

3.50-3.99 

0 

4.00-4.49 

0 

4.50-4.99 

0 

5.00+ 

0 

TOTAL 

705 

2235 

915  0  0  0 

0  0  0  0 

MEAN  HS(M) 

=  1.1 

LARGEST  HS(M)  =  2.4 

MEAN  TP  (SEC)  =  4.7 

PERCENT  OCCURRENCE  (X1000)  OF  HEIGHT  AND  PERIOD  BY  DIRECTION 
22.5  DEGREES  ABOUT  67.5  DEGREES  AZIMUTH 


STATION:  G1033  (29.0N,  85.5W  /  68.0M) 

HEIGHT  PEAK  PERIOD  (IN  SECONDS) 


NO.  CASES:  4915 
%  OF  TOTAL:  8.4 


IN  <4.2 

4.2- 

5.4- 

6.6-  7.5-  8.8-  9.6-  10.6- 

11.9-  13.4-  TOTAL 

METERS 

5.3 

6.5 

7.4  8.7  9.5  10.5 

11.8  13.3  LONGER 

0.00-0.49 

213 

53 

135 

401 

0.50-0.99 

675 

2250 

181 

3106 

1.00-1.49 

3151 

532 

3 

3686 

1.50-1.99 

3 

1052 

6 

1061 

2.00-2.49 

147 

3 

150 

2.50-2.99 

0 

3.00-3.49 

0 

3.50-3.99 

0 

4.00-4.49 

0 

4.50-4.99 

0 

5.00+ 

0 

TOTAL 

888 

5457 

2047 

12  0  0  0  0 

0  0 

MEAN  HS(M) 

=  1.1 

LARGEST  HS(M)  =  2.4  MEAN  TP(SEC)  =  4.8 
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PERCENT  OCCURRENCE  (X1000)  OF  HEIGHT  AND  PERIOD  BY  DIRECTION 
22.5  DEGREES  ABOUT  90.0  DEGREES  AZIMUTH 


STATION:  G10S3  (29.0N,  85. 5W  /  68.0M)  NO.  CASES:  9243 

%  OF  TOTAL:  15.8 

HEIGHT  PEAK  PERIOD  (IN  SECONDS) 


IN 

<4.2 

4.2- 

5.4- 

6.6- 

7.5-  8.8- 

9.6-  10.6- 

11.9- 

13.4-  TOTAL 

METERS 

5.3 

6.5 

7.4 

8.7 

9.5  10.5 

11.8 

13.3  LONGER 

0.00-0.49 

472 

296 

75 

843 

0.50-0.99 

980 

4433 

374 

5787 

1.00-1.49 

2320 

4712 

159 

7191 

1.50-1.99 

18 

874 

831 

44 

1767 

2.00-2.49 

71 

39 

100 

210 

2.50-2.99 

5 

6 

10 

3.00-3.49 

0 

3.50-3.99 

0 

4.00-4.49 

0 

4.50-4.99 

0 

5.00+ 

0 

TOTAL 

1452 

7067 

6111 

1029 

149  0 

0  0 

0 

0 

MEAN  HS(M)  =  1.0  LARGEST  HS(M)  =  2.8  MEAN  TP(SEC)  =  5.2 


PERCENT  OCCURRENCE  (X1000)  OF  HEIGHT  AND  PERIOD  BY  DIRECTION 
22.5  DEGREES  ABOUT  112.5  DEGREES  AZIMUTH 


STATION:  G1033  (29.0N,  85. 5W  /  68.0M) 

NO.  CASES: 

8139 

%  OF  TOTAL: 

13.9 

HEIGHT 

PEAK  PERIOD  (IN  SECONDS) 

IN 

<4.2 

4.2- 

5.4- 

6.6- 

7.5-  8.8-  9.6-  10.6-  11.9-  13.4-  TOTAL 

METERS 

5.3 

6.5 

7.4 

8.7 

9.5  10.5  11.8  13.3  LONGER 

0.00-0.49 

412 

345 

112 

. 

. 

869 

0.50-0.99 

925 

4404 

545 

5874 

1.00-1.49 

716 

4609 

547 

,  ,  ,  ,  , 

5872 

1.50-1.99 

246 

828 

58 

1132 

2.00-2.49 

6 

23 

102 

1 

132 

2.50-2.99 

. 

3 

27 

30 

3.00-3.49 

1 

5 

6 

3.50-3.99 

0 

4.00-4.49 

0 

4.50-4.99 

. 

0 

5.00+ 

0 

TOTAL 

1337 

5465 

5518 

1401 

188 

6  0  0  0  0 

MEAN  HS(M)  ^  l.o 

LARGEST  HS(M)  =  3.2 

MEAN  TP  (SEC)  =  5.3 
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PERCENT  OCCURRENCE  (X1000)  OF  HEIGHT  AND  PERIOD  BY  DIRECTION 
22.5  DEGREES  ABOUT  135.0  DEGREES  AZIMUTH 


STATION:  G1033  (29.0N,  85.5W  /  68.0M)  NO.  CASES:  6876 

%  OF  TOTAL:  11.8 

HEIGHT  PEAK  PERIOD  (IN  SECONDS) 


IN 

<4.2 

4.2- 

5.4- 

6.6- 

7.5- 

8.8- 

9.6-  10.6-  11.9- 

13.4-  TOTAL 

METERS 

5.3 

6.5 

7.4 

8.7 

9.5  10.5  11.8 

13.3  LONGER 

0.00-0.49 

496 

381 

39 

916 

0.50-0.99 

853 

3417 

662 

1 

4933 

1.00-1.49 

1 

638 

3307 

513 

3 

4462 

1.50-1.99 

119 

961 

136 

1216 

2.00-2.49 

23 

160 

3 

186 

2.50-2.99 

15 

15 

30 

3.00-3.49 

11 

11 

3.50-3.99 

0 

4.00-4.49 

0 

4.50-4.99 

0 

5.00+ 

0 

TOTAL 

1350 

4436 

4127 

1498 

314 

29 

0  0  0 

0 

MEAN  HS(M)  =  1.0 


LARGEST  HS(M)  =  3.4 


MEAN  TP  (SEC)  =  5.3 


PERCENT  OCCURRENCE  (X1000)  OF  HEIGHT  AND  PERIOD  BY  DIRECTION 
22.5  DEGREES  ABOUT  157.5  DEGREES  AZIMUTH 


STATION:  G1033  (29.0N,  85.5W  /  68.0M) 

HEIGHT  PEAK  PERIOD  (IN  SECONDS) 


NO.  CASES:  4619 
%  OF  TOTAL:  7.9 


IN 

<4.2 

4.2- 

5.4- 

6.6- 

7.5- 

8.8-  9.6-  10.6- 

11.9- 

13.4-  TOTAL 

METERS 

5.3 

6.5 

7.4 

8.7  9.5  10.5 

11.8 

13.3  LONGER 

0.00-0.49 

133 

128 

77 

338 

0.50-0.99 

627 

1875 

477 

6 

2985 

1.00-1.49 

1 

487 

2345 

319 

1 

3153 

1.50-1.99 

119 

766 

203 

1088 

2.00-2.49 

25 

249 

6 

280 

2.50-2.99 

39 

5 

44 

3.00-3.49 

3 

3 

3.50-3.99 

0 

4.00-4.49 

0 

4.50-4,99 

0 

5.00+ 

0 

TOTAL 

761 

2490 

3018 

1116 

495 

11  0  0 

0 

0 

MEAN  HS(M)  =  1.1 


LARGEST  HS(M)  =  3.0 


MEAN  TP  (SEC)  =  5.5 
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PERCENT  OCCURRENCE  (X1000)  OF  HEIGHT  AND  PERIOD  BY  DIRECTION 
22.5  DEGREES  ABOUT  180.0  DEGREES  AZIMUTH 


STATION:  G1033  (29.0N,  85.5W  /  68.0M)  NO.  CASES:  3024 

%  OF  TOTAL:  5.2 

HEIGHT  PEAK  PERIOD  (IN  SECONDS) 


IN 

<4.2 

4.2- 

5.4- 

6.6- 

7.5- 

8.8-  9.6-  10.6-  11.9- 

13.4-  TOTAL 

METERS 

5.3 

6.5 

7.4 

8.7  9.5  10.5  11.8 

13.3  LONGER 

0.00-0.49 

131 

71 

90 

292 

0.50-0.99 

453 

1483 

277 

2213 

1.00-1.49 

369 

1185 

191 

8 

1753 

1.50-1.99 

100 

503 

97 

700 

2.00-2.49 

1 

34 

159 

1 

195 

2.50-2.99 

6 

5 

11 

3.00-3.49 

0 

3.50-3.99 

0 

4.00-4.49 

0 

4.50-4.99 

0 

5.00+ 

0 

TOTAL 

584 

1923 

1653 

728 

270 

6  0  0  0 

0 

MEAN  HS(M)  =  1.0  LARGEST  HS(M)  =  2.9  MEAN  TP(SEC)  =  5.4 


PERCENT  OCCURRENCE  (X1000)  OF  HEIGHT  AND  PERIOD  BY  DIRECTION 
22.5  DEGREES  ABOUT  202.5  DEGREES  AZIMUTH 


STATION:  G1033  (29.0N,  85.5W  /  68.0M) 

HEIGHT  PEAK  PERIOD  (IN  SECONDS) 

IN  <4.2  4.2-  5.4-  6.6-  7.5-  8.8-  9.6- 

NO.  CASES:  2470 
%  OF  TOTAL:  4.2 

10.6-  11.9-  13.4-  TOTAL 

METERS 

0.00-0.49 

75 

5.3  6.5 

66  66 

7.4 

8.7  9.5 

10.5  11.8  13.3  LONGER 

207 

0.50-0.99 

458 

1401  241 

11 

2111 

1.00-1.49 

241  922 

160 

17 

1340 

1.50-1.99 

87 

302 

53 

6  1 

449 

2.00-2.49 

1 

15 

71 

87 

2.50-2.99 

15 

3 

18 

3.00-3.49 

3 

3 

3.50-3.99 

0 

4.00-4.49 

0 

4.50-4.99 

0 

5.00+ 

. 

0 

TOTAL 

533 

1708  1317 

488 

156 

12  1 

0  0  0 

MEAN  HS(M) 

=  1.0 

LARGEST  HS(M) 

=  3.0 

MEAN  TP(SEC)  =  5.3 
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PERCENT  OCCURRENCE  (X1000)  OF  HEIGHT  AND  PERIOD  BY  DIRECTION 
22.5  DEGREES  ABOUT  225.0  DEGREES  AZIMUTH 


STATION:  G1033  (29.0N,  85. 5W  /  68.0M)  NO.  CASES:  3459 

%  OF  TOTAL:  5.9 

HEIGHT  PEAK  PERIOD  (IN  SECONDS) 


IN 

<4.2 

4.2- 

5.4- 

6.6- 

7.5- 

8.8- 

9.6-  10.6- 

11.9- 

13.4-  TOTAL 

METERS 

5.3 

6.5 

7.4 

8.7 

9.5  10.5 

11.8 

13.3  LONGER 

0.00-0.49 

78 

210 

124 

412 

0.50-0.99 

557 

1810 

272 

25 

1 

2665 

1.00-1.49 

361 

1630 

188 

22 

6 

2207 

1.50-1.99 

83 

311 

59 

5 

458 

2.00-2.49 

20 

85 

3 

108 

2.50-2.99 

1 

35 

6 

42 

3.00-3.49 

. 

, 

13 

13 

3.50-3.99 

0 

4.00-4.49 

, 

0 

4.50-4.99 

0 

5.00+ 

0 

TOTAL 

635 

2381 

2109 

545 

202 

S3 

0  0 

0 

0 

MEAN  HS(M)  =  1.0  LARGEST  HS(M)  =  3.3  MEAN  TP(SEC)  =  5.3 


PERCENT  OCCURRENCE  (X1000)  OF  HEIGHT  AND  PERIOD  BY  DIRECTION 
22.5  DEGREES  ABOUT  247.5  DEGREES  AZIMUTH 


STATION:  G1033  (29.0N,  85.5W  /  68.0M) 

HEIGHT  PEAK  PERIOD  (IN  SECONDS) 


NO.  CASES:  2885 
%  OF  TOTAL:  4.9 


IN 

<4.2 

4.2- 

5.4- 

6.6- 

7.5- 

8.8-  9.6-  10.6- 

11.9- 

13.4- 

TOTAL 

METERS 

5.3 

6.5 

7.4 

8.7  9.5  10.5 

11.8 

13.3  LONGER 

0.00-0.49 

131 

191 

73 

395 

0.50-0.99 

557 

1813 

260 

6 

2636 

1.00-1.49 

1 

278 

968 

181 

6 

1434 

1.50-1.99 

80 

244 

37 

361 

2.00-2.49 

23 

63 

86 

2.50-2.99 

6 

1 

7 

3.00-3.49 

1  3 

4 

3.50-3.99 

0 

4.00-4.49 

0 

4.50-4.99 

0 

5.00+ 

TOTAL 

689 

2282 

1381 

454 

112 

14  0 

0 

0 

0 

MEAN  HS(M)  =  0.9 


LARGEST  HS(M)  =  3.3 


MEAN  TP(SEC)  =  5.1 
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PERCENT  OCCURRENCE  (X1000)  OF  HEIGHT  AND  PERIOD  BY  DIRECTION 
22.5  DEGREES  ABOUT  270.0  DEGREES  AZIMUTH 


STATION:  G1033  (29.0N,  85.5W  /  68.0M)  NO.  CASES:  2210 

%  OF  TOTAL:  3.8 

HEIGHT  PEAK  PERIOD  (IN  SECONDS) 


IN 

<4.2 

4.2- 

5.4- 

6.6- 

7.5- 

8.8-  9.6-  10.6- 

11.9- 

13.4-  TOTAL 

METERS 

5.3 

6.5 

7.4 

8.7  9.5  10.5 

11.8 

13.3  LONGER 

0.00-0.49 

121 

97 

46 

264 

0.50-0.99 

391 

1031 

361 

10 

1793 

1.00-1.49 

1 

140 

740 

189 

10 

1080 

1.50-1.99 

106 

290 

68 

464 

2.00-2.49 

8 

46 

90 

144 

2.50-2.99 

25 

1 

26 

3.00-3.49 

0 

3.50-3.99 

.  . 

0 

4.00-4.49 

. 

0 

4.50-4.99 

0 

5.00+ 

0 

TOTAL 

513 

1268 

1261 

535 

193 

10  0 

0 

0 

MEAN  HS(M)  =  1.0  LARGEST  HS(M)  =  2.8  MEAN  TP(SEC)  =  5.3 


PERCENT  OCCURRENCE  (X1000)  OF  HEIGHT  AND  PERIOD  BY  DIRECTION 
22.5  DEGREES  ABOUT  292.5  DEGREES  AZIMUTH 


STATION:  G1033  (29.0N,  85. 5W  /  68.0M)  NO.  CASES:  2189 

%  OF  TOTAL:  3.7 

HEIGHT  PEAK  PERIOD  (IN  SECONDS) 


IN 

<4.2 

4.2- 

5.4- 

6.6- 

7.5-  8.8- 

9.6-  10.6- 

11.9- 

13.4-  TOTAL 

METERS 

5.3 

6.5 

7.4 

8.7 

9.5  10.5 

11.8 

13.3  LONGER 

0.00-0.49 

44 

56 

58 

158 

0.50-0.99 

301 

939 

330 

1 

1571 

1.00-1.49 

210 

869 

116 

1 

1196 

1.50-1.99 

1 

179 

453 

6 

639 

2.00-2.49 

8 

119 

42 

169 

2.50-2.99 

3 

3 

3.00-3.49 

0 

3.50-3.99 

0 

4.00-4.49 

0 

4.50-4.99 

0 

5.00+ 

0 

TOTAL 

345 

1206 

1444 

689 

52  0 

0  0 

0 

0 

MEAN  HS(M)  =  1.1  LARGEST  HS(M)  =  2.7  MEAN  TP(SEC)  =  5.5 
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PERCENT  OCCURRENCE  (X1000)  OF  HEIGHT  AND  PERIOD  BY  DIRECTION 
22.5  DEGREES  ABOUT  315.0  DEGREES  AZIMUTH 


STATION:  G1033  (29.0N,  85. 5W  /  68.0M) 

HEIGHT  PEAK  PERIOD  (IN  SECONDS) 


NO.  CASES:  1884 
%  OF  TOTAL:  3.2 


IN 

<4.2 

4.2- 

5.4- 

6.6-  7.5-  8.8- 

9.6-  10.6- 

11.9- 

13.4-  TOTAL 

METERS 

5.3 

6.6 

7.4  8.7 

9.5  10.5 

11.8 

13.3  LONGER 

0.00-0.49 

49 

71 

35 

155 

0.50-0.99 

256 

872 

106 

,  , 

1234 

1.00-1.49 

669 

588 

27 

1284 

1.50-1.99 

1 

285 

200  1 

487 

2.00-2.49 

10 

37  1 

48 

2.50-2.99 

1 

5 

6 

3.00-3.49 

0 

3.50-3.99 

0 

4.00-4.49 

0 

4.50-4.99 

0 

5.00+ 

0 

TOTAL 

305 

1613 

1025 

269  2  0 

0  0 

0 

0 

MEAN  HS(M)  =  1.1 


LARGEST  HS(M)  =  2.9 


MEAN  TP(SEC)  =  5.1 


PERCENT  OCCURRENCE  (X1000)  OF  HEIGHT  AND  PERIOD  BY  DIRECTION 
22.5  DEGREES  ABOUT  337.5  DEGREES  AZIMUTH 


STATION:  G1033  (29.0N,  85.5W  /  68.0M)  NO.  CASES:  1465 

%  OF  TOTAL:  2.5 


HEIGHT 

PEAK  PERIOD  (IN  SECONDS) 

IN  <4.2 

4.2- 

5.4- 

6.6-  7.5-  8.8- 

9.6-  10.6- 

11.9-  13.4-  TOTAL 

METERS 

5.3 

6.5 

7.4  8.7 

9.5  10.5 

11.8  13.3  LONGER 

0.00-0.49 

63 

41 

10 

. 

114 

0.50-0.99 

369 

619 

100 

1088 

1.00-1.49 

1 

795 

123 

919 

1.50-1.99 

6 

306 

3 

314 

2.00-2.49 

58 

3 

61 

2.50-2.99 

3 

1 

4 

3.00-3.49 

0 

3.50-3.99 

0 

4.00-4.49 

0 

4.50-4.99 

. 

0 

5.00+ 

. 

0 

TOTAL 

433 

1460 

600 

7  0  0 

0  0 

0  0 

MEAN  HS(M) 

=  1.0 

LARGEST  HS(M)  =  2.7 

MEAN  TP(SEC)  =  4.7 
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PERCENT  OCCURRENCE  (X1000)  OF  HEIGHT  AND  PERIOD 


FOR  ALL  DIRECTIONS 

STATION:  G1033  (29.0N,  85.5W  /  68.0M)  NO.  CASES:  58440 

HEIGHT  PEAK  PERIOD  (IN  SECONDS) 


IN  <4.2  4.2-  5.4-  6.6-  7.5-  8.8-  9.6-  10.6-  11.9-  13.4-  TOTAL 


METERS 

5.3 

6.5 

7.4 

8.7 

9.5 

10.5 

11.8 

13.3 

LONGER 

0.00-0.49 

2600 

2103 

990 

. 

5693 

0.50-0.99 

8740 

8403 

4317 

65 

1 

1526 

1.00-1.49 

11 

3352 

2876 

2599 

71 

6 

. 

8915 

1.50-1.99 

30 

4940 

5710 

768 

11 

1 

1460 

2.00-2.49 

542 

417 

1129 

17 

2105 

2.50-2.99 

11 

11 

181 

37 

1 

241 

3.00-3.49 

5 

35 

3 

43 

3.50-3.99 

0 

4.00-4.49 

. 

0 

4.50-4.99 

0 

5.00+ 

0 

TOTAL 

11351 

43888 

33676 

8802 

2155 

106 

5 

0 

0 

0 

MEAN  HS(M)  =  1.0  LARGEST  HS(M)  =  3.4  MEAN  TP(SEC)  =  5.2 
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Description 

This  application  is  a  numerical  beach  and  dune  erosion  model  that  predicts  the 
evolution  of  an  equilibrium  beach  profile  from  variations  in  water  level  and 
breaking  wave  height  as  occur  during  a  storm.  The  model  is  one-dimensional 
(only  onshore-offshore  sediment  transport  is  represented).  It  is  based  on  the 
theory  that  an  equilibrium  profile  results  from  uniform  wave  energy  dissipation 
per  unit  volume  of  water  in  the  surf  zone.  The  general  characteristics  of  the 
model  are  based  on  a  model  described  by  Kriebel  (1982,  1984a,  1984b,  1986). 
Because  of  the  complexity  of  this  methodology  and  the  input  requirements, 
familiarization  with  the  above  references  is  strongly  recommended. 


Input 

The  input  requirements  of  this  application  consist  of  four  general  types  of 
information. 

°  General  data  describing  temporal  data  to  run  the  model. 

°  Beach  characteristics  (actual  prestorm  profile  or  a  generic  profile). 

0  Changes  in  water  elevation  relative  to  mean  water  level  due  to  storm 
surge  and/or  tides. 

°  Wave  parameters  (height,  period,  direction)  and  associated  water  depth. 
Data  input  to  this  application  is  accomplished  through  numerous  input  screens 
or  through  data  saved  in  external  files,  i.e.,  ACES  trace  file  or  the  Interactive 
Survey  Reduction  Program  (ISRP)  (Birkemeier,  1984)  beach  profile  output  file. 
Detailed  lists  of  the  screens  and  input  parameters  are  presented  in  the  Procedure 
section  of  this  document. 


Output 

Results  from  this  application  are  written  to  the  plot  output  files  (1,  2).  The 
contents  and  organization  of  output  data  in  the  plot  output  files  are  summarized 
below.  In  addition,  this  application  generates  one  plot  (see  section  titled  Plot 
Output  Data). 
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Plot  Output  File  1 

This  file  contains  simulated  profile  data  representing  the  original  profile  and 
evolving,  time-dependent  profiles.  Each  point  along  the  profile  is  defined  by 
some  distance  seaward  of  a  baseline  and  a  corresponding  elevation.  Profiles  are 
reported  at  the  Tabular  Output  Time  Interval.  Plot  output  file  1  is  written  in 
the  following  format: 

Field  Columns  Format  Data 

1  1-9  F9.0  Distance  Seaward  from  Baseline  (X 

Coordinate) 

2  18-23  F6.2  Elevation  (Corresponding  Y  Coordinate) 

Plot  Output  File  2 

This  file  contains  a  table  consisting  of  changes  in  sand  volume  and  changes 
(advance/retreat)  in  position  of  the  0-,  +5-,  +10-,  and  +15-ft  contours.  Erosion 
statistics  are  reported  at  the  Tabular  Output  Time  Interval. 


Field 

Columns 

Format 

Data 

1 

8-11 

14 

Time  (hours)  when  erosion  statistics  are  reported 

2 

19-28 

FI  0.2 

Change  in  sand  volume  above  mean  water  level 

3 

34-43 

F10.2 

Change  in  shoreline  position  at  the  0-ft  contour 

4 

44-53 

F10.2 

Change  in  shoreline  position  at  the  +5-ft  contour 

5 

54-63 

FI  0.2 

Change  in  shoreline  position  at  the  +10-ft  contour 

6 

64-73 

F10.2 

Change  in  shoreline  position  at  the  +15-ft  contour 

Procedure 

This  application  provides  only  a  Single  Case  Mode.  The  Multiple  Case  Mode  is 
not  available.  The  Single  Case  Mode  requires  interaction  with  the  application 
and  provides  three  options  of  interactive  participation.  The  first  option  allows 
entering  a  new  data  set  via  screen  input,  the  second  option  allows  editing  of  data 
sets  read  from  an  external  ACES  trace  file,  and  the  third  option  allows  editing 
of  X,Y  profile  coordinates  read  from  an  external  ISRP  output  file. 


Single  Case  Mode 

The  bulleted  items  in  the  following  lists  indicate  potentially  optional  instruction 
steps.  Any  application  in  ACES  may  be  executed  in  a  given  session  without 
quitting  the  program.  The  bulleted  items  provide  instructions  for  accessing  the 
application  from  various  menu  areas  of  the  ACES  Program.  Ignore  bulleted 
instruction  steps  that  are  not  applicable. 
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Press  (fT)  on  the  Main  Menu  to  select  Single  Case  Mode. 
Fill  in  the  highlighted  input  fields  on  the  General 
Specifications  screen  (or  leave  the  default  values).  Press 
(fi)  when  all  data  on  this  screen  are  correct. 

Press  [F6]  on  the  Functional  Area  Menu  to  select  Littoral 
Processes. 

Press  (F2)  on  the  Littoral  Processes  Menu  to  select  Numerical 
Simulation  of  Time-Dependent  Beach  and  Dune  Erosion. 


Data  Entry  Options  Menu 

This  menu  provides  two  options  of  interactive  participation  with  the  application. 
m  Initial  Case  Data  Entry 

Use  this  option  to  enter  an  initial  (new)  set  of  data.  These  data  will 
be  written  to  the  Trace  Output  file  (default  name  TRACE.OUT)  and 
become  available  for  subsequent  editing  and  use. 

[Alt)  (fT)  Edit  Case  in  External  File:  XSHORE1.IN 

Use  this  option  to  access  and  modify  data  saved  in  an  external  ACES 
trace  file.  This  external  data  file  is  created  by  saving  (or  copying)  a 
trace  file  from  a  previous  execution  of  this  application.  The  format 
and  contents  of  the  trace  file  for  this  application  match  exactly  the 
requirements  of  this  input  file.  The  default  input  file  name  is 
XSHORE1.IN,  but  other  file  names  (including  path  name)  are 
acceptable.  After  entering  the  file  name,  press  [  enter  )  to  accept  this 
file.  For  more  information  on  files,  see  the  section  of  this  manual 
entitled  "General  Instructions  and  Information." 


Activity  Menu 

The  Activity  Menu  is  a  pivotal  point  from  which  all  options  for  Single  Case 
data  entry,  modification,  and  execution  are  accessible.  The  options  are: 

[fT]  Begin  Computations. 

(F2)  General  Time  &  Output  Specifications  Data  Entry,. 

(F3)  Beach  Characteristics  Data  Entry. 

(F4)  Water  Level  Data  Entry. 

(fs)  Wave  Parameter  Data  Entry. 

(f<s)  plot  Output  Data. 

[fio)  Exit  Menu. 

Each  option  and  the  required  data  are  described  below. 
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[hT|  Begin  Computations 

Use  this  option  only  after  all  data  have  been  entered. 


[F2]  General  Time  &  Output  Specifications 

This  screen  provides  for  input  of  general  parameters  required  to  run  the 
application.  Values  for  all  parameters  listed  are  required. 


Item 

Simulation  start  time: 

Units 

Data  Ranee 

Year 

1900 

to 

2050 

Month 

1 

to 

12 

Day 

I 

to 

31 

Hour 

0 

to 

24 

Length  of  simulation 

hr 

1 

to 

120 

Tabular  Output  Time 

interval 

or 

specific  times 

Select  a  Tabular  Output  Time  by  moving  the  cursor  to  the  desired  type  and 
pressing  (x).  Choices  available  are: 

°  Interval 
°  Specific  Times 

Selecting  either  of  these  choices  will  display  a  requestor  for  further  input.  The 
format  and  data  requirements  of  these  requestors  are  described  next. 
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Interval  Output  Time  Requestor 

Enter  an  integer  value  identifying  a  constant  output  time  interval  for  results  to 
be  written  to  the  plot  output  files.  The  range  of  values  allowed  for  the  constant 
interval  is: 

Item  Units  Data  Range 

Interval  hours  1  to  120 

After  entering  an  interval  value,  press  one  of  the  following  keys  to  select  the 
next  appropriate  action: 

(fT)  Accept  Data  &  Exit  Requestor. 

(Alt) [fio j  Return  to  Activity  Menu. 


Specific  Output  Times  Requestor 

Enter  as  many  as  30  integer  values  indicating  the  specific  times  from  beginning 
of  simulation  for  results  to  be  written  to  the  plot  output  files.  The  range  of 
values  allowed  for  the  specific  times  is: 

Item  Units  Data  Range 

Specific  Times  hours  1  to  120 

After  entering  the  desired  specific  times,  press  one  of  the  following  keys  to 
select  the  next  appropriate  action: 

(Alt] CfT]  More  Input. 

NOTE:  Ten  values  can  be  displayed/entered  on  a 
screen.  Press  [alt )(fT)  to  re-invoke  the  screen  for 
subsequent  values. 

(Fl]  Accept  Data  &  Exit  Requestor. 

(Ait)[Fio)  Return  to  Activity  Menu. 
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(F3)  Beach  Characteristics  Data  Entry 

This  option  provides  an  interactive  capability  to  enter  new  or  edit  existing  input 
of  an  original  prestorm  beach  profile.  The  beach  profile  may  be  described  by 
one  of  two  methods: 

1 .  Actual  profile  -  A  series  of  X, Y  coordinate  pairs  that  define  points  along  the 

profile.  The  X  coordinate  represents  distance  seaward  from  a  baseline.  The 
Y  coordinate  represents  a  corresponding  elevation  relative  to  mean  water 
level  (MWL  =  0).  Tn  addition,  the  user  defines  elevations  for  the  top  of  dune 
and  berm  and  mean  grain  size. 

2.  Generic  profile  -  A  schematic  representation  of  a  simple  berm-dune  and 

offshore  system.  See  Figure  6-2-1  for  definition  of  profile  terms. 


l  Y 


The  following  list  describes  parameters  on  the  General  Beach  Characteristics 
screen  with  corresponding  units  and  ranges  of  values  recognized  by  this 
application: 


Item 

Units 

Data  Ranee 

Elevation  at  top  of  dune 

ft,m 

0.0 

to 

9,999.0 

Elevation  at  base  of  dune 

ft,m 

0.0 

to 

below  dune  top 

Elevation  at  top  of  berm 

ft,m 

0.0 

to 

9,999.0 

Dune  width  from  baseline 

ft,m 

0.0 

to 

100.0 

Berm  width 

ft,m 

0.0 

to 

500.0 

Mean  grain  size 

mm 

0.1 

to 

0.5 

Profile 

actual 

or 

generic 
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Select  a  beach  profile  by  moving  the  cursor  to  the  desired  type  and  pressing  ©• 
The  choices  are: 

°  Actual  Beach  Profile 
°  Generic  Beach  Profile 

Selecting  either  of  these  will  display  requestors  for  further  input.  The  format 
and  data  requirements  of  these  requestors  are  described  next. 


Actual  Beach  Profile  Requestor 

When  this  option  is  selected,  the  Actual  Beach  Profile  Point  Data  Entry  Options 
requestor  is  displayed.  This  requestor  invokes  other  requestors  that  collect  choices 
and  input  to  complete  an  actual  beach  profile  definition  for  this  application.  As 
a  minimum,  these  parameters  are  required  to  define  an  actual  profile: 

0  Elevations  at  top  of  dune  and  berm. 

°  Mean  grain  size. 

°  20  survey  points  (X,Y  coordinate  pairs)  along  the  profile. 

The  Actual  Beach  Profile  Data  Entry  Options  requestor  provides  these  choices 
to  complete  a  profile  definition: 

0  Enter/Edit/View  Profile  Data. 

°  Read  an  ISRP  Data  File. 

°  Select  an  ISRP  Profile/  Survey  Number. 


To  make  a  selection,  move  the  cursor  to  the  desired  choice  and  press  Selecting 
a  choice  will  display  requestors  for  further  input. 


Enter/Edit/View  Profile  Data 

This  choice  invokes  the  Actual  Beach  Profile  Point  Data  requestor  that  allows 
for  interactively  entering  a  data  set  of  survey  points  along  a  profile,  editing  a 
profile  data  set,  or  viewing  a  profile  data  set.  The  following  list  describes 
parameters  on  the  Actual  Beach  Profile  Point  Data  requestor  with  their 
corresponding  units  and  range  of  data  recognized  by  this  application: 


Item 

Units 

Data  Ranee 

Profile  data  units 

ft,m 

Distance  from  baseline  (X) 

ft,m 

0.0  to 

4,000.0 

Elevation  (Y) 

ft,m 

-999.0  to 

9,999.0 
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The  first  survey  point  on  the  profile  should  have  a  Distance  from  baseline  (X) 
value  of  zero,  and  the  corresponding  Elevation  ( Y )  value  should  match  the  value 
for  Elevation  at  Top  of  Dune  (General  Beach  Characteristics). 


NOTE:  Minimum  input  parameters  required  to  define  an  actual 
profile  are  Elevations  at  Top  of  Dune  and  Berm,  Mean  Grain  Size, 
and  20  survey  points  (X,Y  coordinate  pairs)  along  the  profile. 


Press  one  of  the  following  keys  to  select  the  next  appropriate  action: 
[Ait)[FT)  Display/Enter  More  Data. 

NOTE:  Twenty  survey  points  can  be  displayed/entered 
on  a  screen.  Press  [Ait)[Fi)  to  re-invoke  the  screen  for 
subsequent  points.  The  maximum  number  of  X/Y  pairs 
allowed  to  define  the  profile  is  200. 

[fT)  Accept  Data  &  Exit. 

[Ait)[Fio]  Exit  Requestor  (do  not  accept  data). 


Read  an  ISRP  Data  File 

If  available,  an  ISRP  data  file  may  be  input  as  an  alternative  to  interactively 
keying  in  actual  profile  data  or  reading  them  from  an  external  ACES  trace  file. 
This  choice  provides  a  requestor  as  a  mechanism  for  declaring  the  name  of  the 
external  file  containing  two-dimensional  profile  data  in  ISRP  Edit-2  format. 
Typically,  data  have  been  saved  in  the  file  from  a  previous  execution  of  ISRP. 
The  default  ISRP  file  name  is  ISRP1.IN,  but  other  file  names  (including  path 
name)  are  acceptable.  After  entering  the  file  name,  press  [  Enter  ]  to  accept  this 
file.  For  more  information  on  ISRP  files,  see  the  following  section,  titled  Format 
of  an  ISRP  Data  File. 

After  specifying  the  name  of  the  file,  press  one  of  the  following  keys  to  select 
the  appropriate  action: 


(fT)  Accept  Data  &  Exit  Requestor. 

NOTE:  Use  this  option  to  open  and  read  the  ISRP  file. 
A  message,  "Please  Wait  -  Reading  data  file,"  is  displayed 
at  the  bottom  of  the  screen  until  the  file  is  read. 
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Only  the  first  216  profile  definitions  in  the  file  are  read 
by  this  application.  If  the  file  contains  more  definitions, 
they  are  ignored.  A  message  indicating  this  limitation 
is  displayed  at  the  bottom  of  the  screen.  This  is  not  an 
error,  the  program  will  continue  accepting  commands. 

A  maximum  of  200  survey  points  along  the  profile  are 
read  by  this  application.  Any  additional  points  on  that 
profile  are  skipped.  A  message  to  that  effect  is  displayed 
at  the  bottom  of  the  screen.  This  is  not  an  error,  the 
program  will  continue  to  read  the  file. 

Upon  successfully  reading  the  file,  a  profile  data  set  can 
be  selected  and  edited  using  procedures  described  in 
Select  an  ISRP  Profile  and  Enter /Edit /View  Profile 
Data  sections  of  this  manual. 

(Ait](Fio)  Exit  Requestor  (do  not  accept  data). 


Select  an  ISRP  Profile 

This  choice  invokes  the  Select  One  ISRP  Profile  Number  requestor  that  allows 
selecting  an  ISRP  profile  by  tagging  the  desired  profile  number.  All  profile 
numbers  identifying  profiles  read  from  the  ISRP  file  are  displayed  as  an  aid  for 
selection  and  tagging.  To  tag  a  profile  for  selection,  move  the  cursor  to  the 
desired  choice  and  press  (x).  Only  one  profile  selection  is  needed  for  each 
computation. 

When  selection  is  complete,  press  one  of  the  following  keys  to  select  the  next 
appropriate  action: 

1aiT](fT)  Next  Screen. 

NOTE:  As  many  as  60  ISRP  profile  names  are  displayed 
on  a  screen. If  more  than  60  are  read  from  the  ISRP 
file,  press  (Alt)(Fl)  to  display  more  profile  names  on 
the  next  screen.  A  maximum  of  216  names  can  be 
displayed. 

(fT)  Accept  Data,  Exit  Requestor. 

( Al~t](no]  Exit  Requestor  (selection  is  not  accepted). 
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Format  of  an  ISRP  Data  File 

The  ISRP  primary  output  is  a  file  defining  profile  line  data  sets  (distance  offshore 
and  elevation)  for  a  specific  area  in  ISRP  Edit-2  format.  The  ISRP  has  more 
than  one  data  file  format;  however,  only  Edit-2  type  data  files  are  recognized 
by  this  application. 

The  first  record  in  an  ISRP  Edit-2  type  data  file  is  a  Header  record  that  provides 
general  information  about  data  in  the  file.  Other  records  in  the  file  define 
profile  data  sets. 


The  following  sections  describe  the  records  including  format,  parameters,  and 
corresponding  range  of  values  recognized  by  this  application.  See  Figure  6-2-2 
for  a  sample  of  an  ISRP  Edit-2  file. 

Header  Record 


Column 

Type 

Item 

Data  Range 

1-2 

Integer 

Header  Record  Identifier 

00 

11 

Integer 

Edit-2  Identifier 

1 

12 

Integer 

Number  of  places  to  right  of  decimal  for 

0 

to 

3 

distance  coordinates 

13 

Integer 

Number  of  places  to  right  of  decimal  for 

0 

to 

3 

elevation  coordinates 

14-15 

Character 

Abbreviation  for  units  of  measurements  of 

ft 

or 

m 

recorded  data 

16-19 

Character 

Vertical  datum  reference 

MSL 

NGVD 

20-69 

Character 

Description 

70-75 

Integer 

Date  file  was  created 

yymmdd 

77-80 

Character 

Initials  of  person  creating  file 

Profile  Data 

Set  Record 

Column 

Type 

Item 

Data  Range 

1-2 

Character 

Locality  code 

any  characters 

3-5 

Integer 

Profile  line  number 

1 

to 

999 

6-9 

Integer 

Survey  identification  number 

1 

to 

9999 

10 

Character 

First  record  of  profile  definition 

1 

11-16 

Integer 

Date  of  survey 

yymmdd 

18-21 

Integer 

Time  of  survey  (24-hour  clock) 

0001 

to 

2400 

22-24 

Integer 

Number  of  X,Y  pairs  in  profile  definition 

20 

to 

200 

25-29 

Integer 

Minimum  elevation  on  profile 

-9999 

to 

99999 

41-45 

Integer 

Distance  coordinate 

0 

to 

99999 

46-50 

Integer 

Elevation  coordinate 

-9999 

to 

99999 

51-55 

Integer 

Distance  coordinate 

0 

to 

99999 

56-60 

Integer 

Elevation  coordinate 

-9999 

to 

99999 

61-65 

Integer 

Distance  coordinate 

0 

to 

99999 

66-70 

Integer 

Elevation  coordinate 

-9999 

to 

99999 

71-75 

Integer 

Distance  coordinate 

0 

to 

99999 

76-80 

Integer 

Elevation  coordinate 

-9999 

to 

99999 
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Profile  Data  Set  Continuation  Record 


Column 

Type 

Item 

Data  Range 

1-2 

Character 

Locality  code 

any  characters 

3-5 

Integer 

Profile  line  number 

1 

to 

999 

6-9 

Integer 

Survey  identification  number 

1 

to 

9999 

10 

Character 

Continuation  record  counter 

2  to  9  and  A  to  Z 

11-15 

Integer 

Distance  coordinate 

0 

to 

99999 

16-20 

Integer 

Elevation  coordinate 

-9999 

to 

99999 

21-25 

Integer 

Distance  coordinate 

0 

to 

99999 

26-30 

Integer 

Elevation  coordinate 

-9999 

to 

99999 

31-35 

Integer 

Distance  coordinate 

0 

to 

99999 

36-40 

Integer 

Elevation  coordinate 

-9999 

to 

99999 

41-45 

Integer 

Distance  coordinate 

0 

to 

99999 

46-50 

Integer 

Elevation  coordinate 

-9999 

to 

99999 

51-55 

Integer 

Distance  coordinate 

0 

to 

99999 

56-60 

Integer 

Elevation  coordinate 

-9999 

to 

99999 

61-65 

Integer 

Distance  coordinate 

0 

to 

99999 

66-70 

Integer 

Elevation  coordinate 

-9999 

to 

99999 

71-75 

Integer 

Distance  coordinate 

0 

to 

99999 

76-80 

Integer 

Elevation  coordinate 

-9999 

to 

99999 

00  101ft  Little  River  Inlet  data 

LR  50  21810430  1200  74  -181 

LR  50  22  50  95  75  85  100  60 

LR  50  23  225  23  250  18  275  15 

LR  50  24  400  -11  425  -17  450  -13 

LR  50  25  700  -61  750  -71  800  -71 

LR  50  26  1050  -109  1100  -118  1150  -120 

LR  50  27  1400  -135  1450  -134  1500  -140 

LR  50  28  1750  -150  1800  -153  1850  -155 

LR  50  29  2100  -160  2150  -174  2200  -165 

LR  50  2A  2450  -169  2500  -171  2550  -171 

LR  50  2B  2800  -175  2850  -180  2900  -178 

LR  50  31810715  1200  76  -193 

LR  50  32  60  85  80  76  100  60 

LR  50  33  200  29  220  22  240  26 

LR  50  34  340  -2  360  -8  380  -13 

LR  50  35  480  -29  500  -40  550  -40 

LR  50  36  800  -86  850  -90  900  -104 

LR  50  37  1150  -128  1200-133  1250  -132 

LR  50  38  1500  -152  1550  -154  1600  -152 

LR  50  39  1850  -159  1900  -168  1950  -162 

LR  50  3A  2200  -170  2250  -173  2300  -173 

LR  50  3B  2550  -180  2600  -181  2650  -185 

LR  50  3C  2900  -191  2950  -193  0  0 

LR  50  41811015  1200  67  -200 

LR  50  42  75  79  100  63  125  53 

LR  50  43  250  15  275  10  300  5 

LR  50  44  450  -71  500  -82  550  -86 

LR  50  45  800  -109  850  -126  900  -121 

LR  50  46  1150  -140  1200  -143  1250  -145 

LR  50  47  1500  -160  1550  -153  1600  -160 

LR  50  48  1850  -161  1900  -169  1950  -164 

LR  50  49  2200  -171  2250  -179  2300  -180 

LR  50  4A  2550  -181  2600  -184  2650  -181 

LR  50  51820115  1200  60  -190 

LR  50  52  150  40  175  34  200  28 

LR  5  0  5  3  325  7  350  3  375  -2 

LR  50  54  600  -102  650  -104  700  -114 

LR  50  55  950  -134  1000  -136  1050  -140 

LR  50  56  1300  -157  1350  -158  1400  -155 

LR  50  57  1650  -167  1700  -163  1750  -170 

LR  50  58  2000  -170  2050  -177  2100  -176 

LR  50  59  2350  -182  2400  -188  2450  -185 


MAC 

0  93  20  127  25  117  35  98 

125  46  150  36  175  31  200  27 

300  12  325  6  350  1  375  -6 

500  -42  550  -43  600  -42  650  -53 

850  -85  900  -90  950  -96  1000  -99 

1200  -115  1250  -125  1300  -129  1350  -133 

1550  -141  1600  -142  1650  -150  1700  -148 

1900  -157  1950  -164  2000  -163  2050  -165 

2250  -173  2300  -172  2350  -175  2400  -168 

2600  -171  2650  -172  2700  -176  2750  -176 

2950  -181  3000  -180  3050  -180  3100  -180 

0  92  20.  26  35  96  40  95 

120  49  140  37  160  35  180  33 

260  21  280  15  300  9  320  3 

400  -15  420  -11  440  -11  460  -14 

600  -44  650  -60  700  -63  750  -80 

950  -109  1000  -102  1050  -116  1100  -121 

1300  -138  1350  -144  1400  -143  1450  -150 

1650  -158  1700  -159  1750  -159  1800  -160 

2000  -170  2050  -170  2100  -168  2150  -172 

2350  -174  2400  -180  2450  -178  2500  -183 

2700  -190  2750  -188  2800  -188  2850  -190 

00000000 
0  93  20  127  25  118  50  94 

150  40  175  32  200  29  225  19 

325  -1  350  -4  375  -8  400  -20 

600  -92  650  -100  700  -104  750  -117 

950  -125  1000  -130  1050  -137  1100  -140 

1300  -146  1350  -148  1400  -153  1450  -147 

1650  -161  1700  -160  1750  -159  1800  -168 

2000  -172  2050  -169  2100  .-171  2150  -180 

2350  -175  2400  -180  2450  -183  2500  -182 

2700  -190  2750  -191  2800  -190  2850  -200 

50  93  75  79  100  66  125  49 

225  23  250  19  275  14  300  9 

400  -7  450  -82  500  -88  550  -97 

750  -120  800  -120  850  -123  900  -132 

1100  -145  1150  -149  1200  -147  1250  -153 

1450  -160  1500  -161  1550  -159  1600  -168 

1800  -164  1850  -168  1900  -172  1950  -172 

2150  -177  2200  -179  2250  -180  2300  -186 

2500  -186  2550  -187  2600  -190  2650  -190 


Figure  6-2-2.  Sample  of  an  ISRP  Edit-2  File 
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Generic  Beach  Profile  Requestor 

This  choice  invokes  the  Generic  Beach  Profile  Parameters  requestor  that  collects 
additional  input  for  completing  a  schematic  representation  of  an  idealized  profile. 
When  Elevation  At  Top  of  Dune  is  entered,  then  Elevation  At  Base  of  Dune  and 
Cotangent  of  Dune  Face  Slope  are  required.  When  Elevation  At  Top  of  Berm  is 
entered,  then  Cotangent  of  Beach  Slope  is  required.  In  addition.  Mean  Grain 
Size  and  Cotangent  of  Nearshore  Slope  are  always  required.  The  following  list 
describes  parameters  on  the  Generic  Beach  Profile  Parameters  requestor  with 
their  corresponding  units  and  range  of  data  recognized  by  this  application: 

Item  Data  Ranee 


Cotangent  of  dune  face  slope 

1.0 

to 

10.0 

Cotangent  of  beach  face  slope 

1.0 

to 

20.0 

Cotangent  of  nearshore  slope 

20.0 

to 

60.0 

Press  one  of  the  following  keys  to  select  the  next  appropriate  action: 
(fT)  Accept  Data  &  Exit  Requestor. 

f Ait](Fio]  Exit  Requestor  (do  not  accept  data). 


(F4)  Water  Level  Data  Entry 

This  series  of  screens  provides  for  input  of  water  level  variations  for  the  model. 

Water  levels  may  be  described  by  one  or  both  of  the  following  methods: 

1.  Tabulated  entries  (100  maximum)  collected  by  a  tide  gage  at  a  constant 
sampling  interval. 

2.  Tides  as  a  constituent  tide  record  with  an  amplitude  and  corresponding  epoch 
for  any  of  37  constituents.  The  major  tidal  constituents  accepted  by  this 
application  are  listed  in  Table  A-5  in  Appendix  A. 

NOTE:  The  final  water  level  used  in  the  model  will  be  the  sum 
of  tabulated  entries  and  a  constituent  tide  record.  The  model  will 
also  run  without  water  level  data. 
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From  the  menu  on  the  screen  Identify  Type  of  Time-Series  Water  Level  Data, 
press: 

[fT]  To  access  the  screen  for  entering  tabulated  data. 

(F2)  To  access  the  screen  for  entering  constituent  tide  data. 

Tabulated  Data 


Item 

Units 

Data  Ranee 

At  for  hydrograph  input 

hr 

1.0  to 

120.0 

Water  level  units 

ft,m 

Water  levelsm 

ft,m 

0.0  to 

20.0 

(m=l...M,  M  £  1 00) 


NOTE:  Enter  water  levels  relative  to  Mean  Water  Level  (MWL) 
=  0.  First  water  level  must  be  0.0.  Each  screen  will  accept  a 
maximum  of  20  values. 

Press  one  of  the  following  keys  to  select  the  next  appropriate  action: 

(fT)  More  Input. 

NOTE:  Use  this  option  to  continue  tabulated  input 
(maximum  100  values). 

[AltHFlO)  Return. 


Constituent  Tide  Data 


Item 

Units 

Data  Ranee 

Gage  longitude 

deg  WEST 

-180.0  to  180.00 

Amplitude  units 

ft,m 

Amplitude  of  individual 

ft,m 

0.0  to  999.99 

constituent 

Epoch  of  individual 

deg 

0.0  to  360.00 

constituent,! 

NOTE:  The  names  of  37  common  harmonic  constituents  (see 
Table  A-5,  Appendix  A)  are  displayed  on  a  series  of  screens. 
Place  the  values  of  amplitude  and  epoch  at  the  appropriate  desired 
constituent  name. 
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Press  one  of  the  following  keys  to  select  the  next  appropriate  action: 

[ft]  More  Input. 

NOTE:  Use  this  option  to  continue  additional  constituent 
input  on  subsequent  screens. 

(Ait][Fio]  Return. 


[FS]  Wave  Parameter  Data  Entry 

This  series  of  screens  provides  for  input  of  wave  parameters  and  an  associated 
water  depth  for  the  model.  Wave  parameters  are  collected  at  a  constant  time 
interval  and  constant  water  depth. 


Item 

Units 

Data  Ranee 

At  for  wave  parameters 

hr 

1.0 

to 

120.00 

Wave  height  units 

ft,m 

Water  depth 

ft,m 

5.0 

to 

9,999.99 

Wave  height 

ft,m 

1.0 

to 

30.00 

Wave  period 

sec 

1.0 

to 

30.00 

Wave  crest  angle 

deg 

0.0 

to 

89.00 

Press  one  of  the  following  keys  to  select  the  next  appropriate  action: 

(fT)  More  Input. 

NOTE:  Ten  wave  records  can  be  displayed/entered  on 
a  screen.  Press  [altKfi]  to  re-invoke  the  screen  for 
subsequent  values. 

[Alt][Fio]  Return  to  Activity  Menu. 


(F6)  Plot  Output  Data 

This  application  generates  one  plot  with  two  curves  (see  Figure  6-2-3).  The  two 
curves  are: 

°  Original  profile. 

°  Computer  profile  at  the  end  of  the  simulation  time. 
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Application  Restrictions,  Requirements,  and  Limitations 

Listed  below  are  some  restrictions,  requirements,  and  limitations  of  this 
application. 


°  If  the  profile  used  in  this  application  is  a  Generic  profile,  then  the 
water  depth  at  the  gage  must  be  at  least  twice  the  maximum  wave 
height  that  is  used. 

°  If  the  profile  that  is  used  is  an  Actual  profile,  then  the  maximum 
profile  depth  must  be  equal  to  or  greater  than  twice  the  maximum 
wave  height  that  is  used. 

0  If  the  entire  profile  becomes  submerged  during  execution  of  this 
application,  then  the  program  will  stop  and  the  user  will  be  requested 
to  check  the  water  depth  entry  and  Water  Level  Data  Entry  option. 

0  This  application  can  be  used  to  determine  the  beach  response  profile 
in  front  of  a  seawall  by  assuming  that  the  seawall  is  located  at  X  =  0 
on  the  profile. 

°  Calculations  over  the  horizontal  grid  of  the  model  are  carried  out  to  a 
maximum  depth  of  45  ft. 
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Example  1  -  Generic  Profile  with  Constituent  Tide  Data 
Input 

All  input  is  accomplished  through  screens  accessible  from  the  Activity  Menu. 


(F2)  General  Time  &  Output  Specifications  Data  Entry 


Item 

Simulation  start  time: 

Value 

Units 

Year 

1989 

Month 

1 

Day 

10 

Hour 

10.00 

Length  of  simulation 

20.00 

hr 

Tabular  output  time  (Interval) 

2.00 

hr 

[F3]  Beach  Characteristics  Data  Entry 


Item 

Value 

Units 

Elevation  at  top  of  dune 

20.000 

ft 

Elevation  at  base  of  dune 

6.000 

ft 

Elevation  at  top  of  berm 

6.000 

ft 

Dune  width  from  baseline 

50.000 

ft 

Berm  width 

100.000 

ft 

Mean  grain  size 

0.220 

mm 

Profile 

GENERIC 

Generic  Profile  Data 

Item 

Value 

Units 

Cotangent  of  dune  face  slope 

2.000 

Cotangent  of  beach  face  slope 

10.000 

Cotangent  of  nearshore  slope 

20.000 
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[F4]  Water  Level  Data  Entry 


(fz)  Constituent  Tide  Data  (see  Table  A-5,  Appendix  A) 


Item 

Value 

Units 

Gage  longitude 

75.00 

deg  WEST 

Amplitude  units 

ft 

Amplitude  of  individual  constituentn  (M4) 

4.00 

ft 

Epoch  of  individual  constituent  (M4) 

90.00 

deg 

NOTE:  All  other  common  harmonic  constituents  are  0.0  for  this 
example. 


[F5]  Wave  Parameter  Data  Entry 


Item 

Value 

Units 

At  for  wave  parameters 

20.00 

hr 

Wave  height  units 

ft 

Water  depth 

60.00 

ft 

Wave  height 

8.00 

ft 

Wave  period 

8.00 

sec 

Wave  crest  angle 

10.00 

deg 

Output 

Results  from  this  application  are  written  to  two  plot  output  files.  In  addition, 
this  application  generates  one  screen  plot. 


Plot  Output  File  1 

This  file  contains  simulated  profile  data  representing  the  original  profile  and 
evolving,  time-dependent  profiles.  Each  point  along  the  profile  is  defined  by 
some  distance  seaward  of  a  baseline  and  a  corresponding  elevation.  Profiles  are 
reported  at  the  Tabular  Output  Time  Interval.  Table  6-2-1  is  a  partial  listing  of 
plot  output  file  1  (default  name  PLOTDATl.OUT).  Figure  6-2-3  is  a  plot 
comparing  the  original  profile  with  the  20-hr  profile. 
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Table  6-2-1 

Listing  of  Plot  Output  File  1  for  Example  Problem  1 
Original  Profile  Data 


Dist.  Seaward 
from  Baseline  (ft) 

Elev.(ft) 

0. 

20.00 

4. 

20.00 

8. 

20.00 

4 

4 

212. 

2.40 

216. 

2.00 

220. 

1.60 

224. 

1.20 

228. 

0.80 

232. 

0.40 

4 

4 

1128. 

-44.60 

1132. 

-44.80 

1136. 

-45.00 

Profile  Data  at  2  hr 

Dist.  Seaward 

Elev.(ft) 

from  Baseline  (ft) 

0. 

20.00 

4. 

20.00 

8. 

20.00 

4 

4 

212. 

2.10 

216. 

1.46 

220. 

1.08 

224. 

0.78 

228. 

0.49 

232. 

0.22 

4 

4 

1128. 

-44.60 

1132. 

-44.80 

1136. 

-45.00 

(Table  6-2-1  Continued  on  the  Next  Page) 
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(Table  6-2-1  Concluded) 


Profile  Data  at  20  hr 

Dist.  Seaward 

Elev.(ft) 

from  Baseline  (ft) 

0. 

20.00 

4. 

20.00 

8. 

20.00 

4 

4 

204, 

208. 

212. 

216. 

220. 

224. 

228. 

232. 

236. 

1 

1128. 

1132. 

1136. 


1.63 

1.26 

0.91 

0.59 

0.29 

0.00 

-0.28 

-0.55 

-0.81 

l 

-44.60 

-44.80 

-45.00 


Figure  6-2-3.  Profile  Change  After  20  Hr 
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Plot  Output  File  2 

This  file  contains  a  table  consisting  of  changes  in  sand  volume  and  changes 
(advance/retreat)  in  position  of  the  0-,  +5-,  +10-,  and  +15-ft  contours.  Erosion 
statistics  are  reported  at  the  Tabular  Output  Time  Interval.  Table  6-2-2  is  a 
listing  of  plot  output  file  2  (default  name  PL0TDAT2.0UT). 


Table  6-2-2 

Listing  of  Plot  Output  File  2  for  Example  Problem  1 


Hour  Change  in  Contour  Change  (ft) 

Volume 
(yd3/ft) 


0 

+5 

+10 

+15 

2 

-1.05 

-0.63 

-2.98 

-0.14 

-0.14 

4 

-0.94 

-0.40 

-2.84 

-0.11 

-0.11 

6 

-1.13 

-5.13 

-2.94 

-0.14 

-0.14 

8 

-2.87 

-6.28 

-4.84 

-0.52 

-0.52 

10 

-2.80 

-6.12 

-4.73 

-0.49 

-0.49 

12 

-2.96 

-7.21 

-4.97 

-0.54 

-0.54 

14 

-4.87 

-9.26 

-8.05 

-1.16 

-1.16 

16 

-4.87 

-10.43 

-8.04 

-1.16 

-1.16 

18 

-4.82 

-10.37 

-7.97 

-1.14 

-1.14 

20 

-6.80 

-12.05 

-11.66 

-1.74 

-1.74 

(Example  1  Concluded) 
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Example  2  -  Generic  Profile  with  No  Water  Level  Data 


Input 

All  input  is  accomplished  through  screens  accessible  from  the  Activity  Menu. 


(eD  General  Time  &  Output  Specifications  Data  Entry 


Item 

Simulation  start  time: 

Value 

Units 

Year 

1989 

Month 

1 

Day 

17 

Hour 

3.00 

Length  of  simulation 

20.00 

hr 

Tabular  output  time  (Interval) 

2.00 

hr 

|F3]  Beach  Characteristics  Data  Entry 


Item 

Value 

Units 

Elevation  at  top  of  dune 

20.000 

ft 

Elevation  at  base  of  dune 

6.000 

ft 

Elevation  at  top  of  berm 

6.000 

ft 

Dune  width  from  baseline 

50.000 

ft 

Berm  width 

100.000 

ft 

Mean  grain  size 

0.220 

mm 

Profile 

GENERIC 

Generic  Profile  Data 

Item 

Value 

Units 

Cotangent  of  dune  face  slope 

2.000 

Cotangent  of  beach  face  slope 

10.000 

Cotangent  of  nearshore  slope 

20.000 

Wave  Parameter  Data  Entry 

Item 

Value 

Units 

At  for  wave  parameters 

20.00 

hr 
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Wave  height  units 

ft 

Water  depth 

60.00  ft 

Wave  height 

8.00  ft 

Wave  period 

8.00  sec 

Wave  crest  angle 

10.00  deg 

Output 

Results  from  this  application  are 

written  to  two  plot  output  files.  In  addition, 

this  application  generates  one  screen  plot. 

Plot  Output  File  1 

This  file  contains  simulated  profile  data  representing  the  original  profile  and 
evolving,  time-dependent  profiles.  Each  point  along  the  profile  is  defined  by 
some  distance  seaward  of  a  baseline  and  a  corresponding  elevation.  Profiles  are 
reported  at  the  Tabular  Output  Time  Interval.  Table  6-2-3  is  a  partial  listing  of 

plot  output  file  1  (default  name 

:  PLOTDAT1  .OUT).  Figure  6-2-4  is  a  plot 

comparing  the  original  profile  with  the  20-hr  profile. 

Table  6-2-3 

Listing  of  Plot  Output  File  1  for  Example  Problem  2 

Original  Profile  Data 

Dist.  Seaward 
from  Baseline  (ft) 

Elev.(ft) 

0. 

20.00 

4. 

20.00 

8. 

20.00 

1 

208. 

2.80 

212. 

2.40 

216. 

2.00 

220. 

1.60 

224. 

1.20 

228. 

0.80 

232. 

0.40 

11 

1128. 

-44.60 

1132. 

-44.80 

1136. 

-45.00 

(Table  6-2-3  Continued  on  the  Next  Page) 
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(Table  6-2-3  Concluded) 
Profile  Data  at  2  hr 


Dist.  Seaward 
from  Baseline  (ft) 

Elev.(ft) 

0. 

20.00 

4. 

20.00 

8. 

20.00 

4 

4 

208. 

2.78 

212. 

2.38 

216. 

1.98 

220. 

1.58 

224. 

1.18 

228. 

0.78 

232. 

0.38 

4 

4 

1128. 

-44.60 

1132. 

-44.80 

1136. 

-45.00 

Profile  Data  aj  20  hr 

Dist.  Seaward 

Elev.(ft) 

from  Baseline  (ft) 

0. 

20.00 

4. 

20.00 

8. 

20.00 

4 

4 

208. 

1.59 

212. 

1.19 

216. 

0.79 

220. 

0.39 

224. 

-0.01 

228. 

-0.61 

232. 

-0.97 

4 

4 

1128. 

-44.60 

1132. 

-44.80 

1136. 

-45.00 
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Figure  6-2-4.  Profile  Change  After  20  Hr 

Plot  Output  File  2 

This  file  contains  a  table  consisting  of  changes  in  sand  volume  and  changes 
(advance/retreat)  in  position  of  the  0-,  +5-,  +10-,  and  +15-ft  contours.  Erosion 
statistics  are  reported  at  the  Tabular  Output  Time  Interval.  Table  6-2-4  is  a 
listing  of  plot  output  file  2  (default  name  PLOTDAT2.0UT). 


Table  6-2-4 

Listing  of  Plot  Output  File  2  for  Example  Problem  2 
Hour  Change  in  Contour  Change  (ft) 


Volume 

(yd3/ft) 


0 

+5 

+10 

+15 

2 

-0.01 

-0.18 

-0.18 

0.00 

0.00 

4 

-0.41 

-1.94 

-1.94 

0.00 

0.00 

6 

-0.89 

-4.14 

-4.14 

0.00 

0.00 

8 

-1.51 

-5.90 

-5.90 

-0.10 

-0.10 

10 

-2.13 

-7.24 

-6.82 

-0.28 

-0.28 

12 

-2.85 

-7.92 

-7.88 

-0.49 

-0.49 

14 

-3.59 

-8.98 

-8.98 

-0.71 

-0.71 

16 

-4.34 

-10.09 

-10.09 

-0.94 

-0.94 

18 

-4.98 

-11.40 

-11.03 

-1.13 

-1.13 

20 

-5.69 

-12.14 

-12.07 

-1.34 

-1.34 

(Example  2  Concluded) 


Numerical  Simulation  of  Time -Dependent  Beach  and  Dune  Erosion 


Littoral  Proceases 


ACES  User's  Guide 


Example  3  -  Generic  Profile  with  Tabulated  Water  Data 


Input 

All  input  is  accomplished  through  screens  accessible  from  the  Activity  Menu. 


(F2]  General  Time  &  Output  Specifications  Data  Entry 


Item 

Simulation  start  time: 

Value 

Units 

Year 

1989 

Month 

1 

Day 

17 

Hour 

2.50 

Length  of  simulation 

20.00 

hr 

Specific  output  times  from  1,  2, 

4,  6,  8,  10, 

hr 

beginning  of  the  simulation  12, 

14,  16,  18, 

(Tabulated) 

20 

(F3]  Beach  Characteristics  Data  Entry 

Item 

Value 

Units 

Elevation  at  top  of  dune 

14.100 

ft 

Elevation  at  base  of  dune 

6.000 

ft 

Elevation  at  top  of  berm 

6.000 

ft 

Dune  width  from  baseline 

50.000 

ft 

Berm  width 

100.000 

ft 

Mean  grain  size 

0.220 

mm 

Profile 

GENERIC 

Generic  Profile  Data 

Item 

Value 

Units 

Cotangent  of  dune  face  slope 

2.000 

Cotangent  of  beach  face  slope 

10.000 

Cotangent  of  nearshore  slope 

20.000 

Numerical  Simulation  of  Time-Dependent  Beach  and  Dune  Erosion 


6-2-25 


ACES  User's  Guide 


Littoral  Processes 


(F4)  Water  Level  Data  Entry 


(fi)  Tabulated  Tide  Data 


Item 

Value 

Units 

At  for  hydrograph  input 

4.000 

hr 

Water  level  units 

ft 

Water  levelsm 

0,  3,  5,  7,  5,  2 

(m  =  M<100) 


(ED  Wave  Parameter  Data  Entry 


Item 

Value 

Units 

Affor  wave  parameters 

5.00 

hr 

Wave  height  units 

ft 

Water  depth 

60.00 

ft 

Wave  heights 

8,  5,  3,  12 

ft 

Wave  periods 

8,  5,  4,  10 

sec 

Wave  crest  angles 

10,  45,  30,  0 

deg 

Output 

Results  from  this  application  are  written  to  two  plot  output  files.  In  addition, 
this  application  generates  one  plot. 

Plot  Output  File  1 

This  file  contains  simulated  profile  data  representing  the  original  profile  and 
evolving,  time-dependent  profiles.  Each  point  along  the  profile  is  defined  by 
some  distance  seaward  of  a  baseline  and  a  corresponding  elevation.  Profiles  are 
reported  at  the  Tabular  Output  Time  Interval.  Table  6-2-5  is  a  partial  listing  of 
plot  output  file  1  (default  name  PLOTDATl.OUT).  Figure  6-2-5  is  a  plot 
comparing  the  original  profile  with  the  20-hr  profile. 
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Table  6-2-5 

Listing  of  Plot  Output  File  1  for  Example  Problem  3 
Original  Profile  Data 

Dist.  Seaward  Elev.(ft) 

from  Baseline  (ft) 

0. 

4. 

8. 

12. 

I 

208. 

212. 

216. 

220. 

224. 

228. 

232. 

4 

1128. 

1132. 

1136. 


Profile  Data  at  1  hr 

Dist.  Seaward 

Elev.(ft) 

from  Baseline  (ft) 

0. 

20.00 

4. 

20.00 

8. 

20.00 

12. 

20.00 

4 

4 

208. 

2.82 

212. 

2.42 

216. 

2.02 

220. 

1.62 

224. 

1.22 

228. 

0.82 

232. 

0.42 

4 

4 

1128. 

-44.60 

1132. 

-44.80 

1136. 

-45.00 

(Table  6-2-5  Continued  on  the  Next  Page) 

20.00 

20.00 

20.00 

20.00 

4 

2.80 

2.40 

2.00 

1.60 

1.20 

0.80 

0.40 

4 

-44.60 

-44.80 

-45.00 


Numerical  Simulation  of  Time-Dependent  Beach  and  Dune  Erosion 


6-2-27 


ELEVATION  CftI 


ACES  User's  Guide 


Littoral  Processes 


(Table  6-2-5  Concluded) 


Profile  Data  at  20  hr 
Dist.  Seaward 
from  Baseline  (ft) 

0. 

4. 

8. 

4 

200. 

204. 

208. 

212. 

216. 

220. 

224. 

228. 

232. 

236. 

240. 


Elev.(ft) 


20.00 

20.00 

20.00 

4 


1.77 

1.58 

1.39 

1.19 

1.00 

0.80 

0.60 

0.40 

0.20 

0.00 

-0.21 


4 


4 


1128. 

1132. 

1136. 


-44.60 

-44.80 

-45.00 


Figure  6-2-5.  Profile  Change  After  20  Hr 
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Plot  Output  File  2 

This  file  contains  a  table  consisting  of  changes  in  sand  volume  and  changes 
(advance/retreat)  in  position  of  the  0-,  +5-,  +10-,  and  +15-ft  contours.  Erosion 
statistics  are  reported  at  the  Tabular  Output  Time  Interval.  Table  6-2-6  is  a 
listing  of  plot  output  file  2  (default  name  PL0TDAT2.0UT). 


Table  6-2-6 

Listing  of  Plot  Output  File  2  for  Example  Problem  3 


Hour 

Change  in 

Contour  Change  (ft) 

Volume 

(yd3/ft) 

0 

+5 

+10 

+15 

1 

0.08 

0.23 

0.22 

0.00 

0.00 

2 

-0.01 

-0.18 

-0.18 

0.00 

0.00 

4 

-0.41 

-1.94 

-1.94 

0.00 

0.00 

6 

-1.98 

-1.17 

-10.14 

0.00 

0.00 

8 

-2.87 

1.45 

-11.07 

-0.29 

-0.29 

10 

-3.54 

23.19 

-13.00 

-0.82 

-0.82 

12 

-3.95 

34.73 

-14.31 

-1.28 

-1.28 

14 

-6.15 

34.73 

-46.76 

-1.95 

-1.95 

16 

-5.56 

34.73 

-52.90 

-1.64 

-1.64 

18 

-5.78 

8.86 

-48.78 

-1.42 

-1.42 

20 

-7.41 

-0.07 

-48.45 

-1.40 

-1.40 

(Example  3  Concluded) 
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Example  4  -  Actual  Profile  Data  with  No  Water  Level  Data 


Input 


All  input  is  accomplished  through  screens  accessible  from  the  Activity  Menu. 


[F2]  General  Time  &  Output  Specifications  Data  Entry 


Item 

Simulation  start  time: 

Value 

Units 

Year 

1989 

Month 

1 

Day 

17 

Hour 

3.00 

Length  of  simulation 

20.00 

hr 

Tabular  output  time  (Interval) 

2.00 

hr 

|F3)  Beach  Characteristics  Data  Entry 


Item 

Value 

Units 

Elevation  at  top  of  dune 

14.100 

ft 

Elevation  at  base  of  dune 

6.000 

ft 

Elevation  at  top  of  berm 

6.000 

ft 

Dune  width  from  baseline 

50.000 

ft 

Berm  width 

100.000 

ft 

Mean  grain  size 

0.220 

mm 

Profile 

ACTUAL 
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Actual  Profile  Data 


Distance 

Elevation 

Distance 

Elevation 

Seaward 

Seaward 

from 

from 

Baseline 

Baseline 

Pt 

X 

Y 

Pt 

X 

Y 

1 

0.000 

14.100 

28 

772.900 

-9.000 

2 

4.000 

13.400 

29 

821.800 

-7.600 

3 

11.200 

13.100 

30 

883.900 

-7.500 

4 

25.100 

10.600 

31 

957.000 

-10.000 

5 

45.000 

15.000 

32 

975.600 

-11.300 

6 

54.400 

14.100 

33 

998.000 

-12.000 

7 

75.700 

12.500 

34 

1028.000 

-13.400 

8 

105.200 

12.900 

35 

1076.000 

-16.100 

9 

139.600 

13.500 

36 

1120.000 

-18.100 

10 

163.900 

12.500 

37 

1153.000 

-19.200 

11 

189.400 

10.500 

38 

1190.000 

-20.500 

12 

205.500 

8.600 

39 

1226.000 

-21.500 

13 

242.500 

4.300 

40 

1285.000 

-22.900 

14 

281.600 

2.300 

41 

1316.000 

-23.000 

15 

320.600 

1.100 

42 

1372.000 

-24.400 

16 

374.700 

0.400 

43 

1421.000 

-25.500 

17 

393.700 

0.200 

44 

1485.000 

-26.500 

18 

421.300 

-0.500 

45 

1532.000 

-27.200 

19 

453.600 

-3.100 

46 

1585.000 

-28.300 

20, 

497.300 

-6.900 

47 

1625.000 

-29.200 

21 

539.200 

-7.000 

48 

1682.000 

-30.100 

22 

577.400 

-6.600 

49 

1723.000 

-30.400 

23 

626.700 

-7.600 

50 

1777.000 

-31.100 

24 

638.700 

-8.700 

51 

1821.000 

-31.500 

25 

672.600 

-9.800 

52 

1870.000 

-32.200 

26 

721.900 

-9.700 

53 

1916.000 

-32.400 

27 

735.700 

-8.800 

(fs)  Wave  Parameter  Data  Entry 


Item 

Value 

Units 

At  for  wave  parameters 

20.00 

hr 

Wave  height  units 

ft 

Water  depth 

60.00 

ft 

Wave  height 

8.00 

ft 

Wave  period 

8.00 

sec 

Wave  crest  angle 

10.00 

deg 
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Figure  6-2-6.  Profile  Change  After  20  Hr 

Plot  Output  File  2 


This  file  contains  a  table  consisting  of  changes  in  sand  volume  and  changes 
(advance/retreat)  in  position  of  the  0-,  +5-,  +10-,  and  +15-ft  contours.  Erosion 
statistics  are  reported  at  the  Tabular  Output  Time  Interval.  Table  6-2-8  is  a 
listing  of  plot  output  file  2  (default  name  PL0TDAT2.0UT). 


Table  6-2-8 

Listing  of  Plot  Output  File  2  for  Example  Problem  4 
Hour  Change  in  Contour  Change  (ft) 

Volume 


(yd3/ft) 


0 

+5 

+10 

+15 

2 

-1.68 

-17.54 

-2.41 

0.00 

0.00 

4 

-2.76 

-34.67 

-3.98 

0.00 

0.00 

6 

-3.50 

-48.52 

-5.09 

0.00 

0.00 

8 

-4.07 

-58.17 

-5.96 

-0.18 

0.00 

10 

-4.54 

-64.89 

-6.69 

-0.84 

0.00 

12 

-4.94 

-69.85 

-7.29 

-1.39 

0.00 

14 

-5.28 

-73.61 

-7.79 

-1.86 

0.00 

16 

-5.59 

-76.76 

-8.25 

-2.33 

0.00 

18 

-5.85 

-79.29 

-8.65 

-2.73 

0.00 

20 

-6.07 

-81.33  -8.99 

(Example  4  Concluded) 
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Description 


The  major  concern  in  the  design  of  a  sediment  sampling  plan  for  beach-fill 
purposes  is  determining  the  composite  grain-size  characteristics  of  both  the  native 
beach  and  the  potential  borrow  site.  This  application  calculates  a  composite 
grain-size  distribution  that  reflects  textural  variability  of  the  samples  collected 
at  the  native  beach  or  the  potential  borrow  area. 


Input 

The  input  requirements  of  this  application  consist  of  (a)  entering  and/or  editing 
sand  sample  weights  and  germane  identification  characteristics,  (b)  selecting 
samples  to  be  used  in  calculating  the  composite  grain-size  distribution,  and  (c) 
selecting  multiple  samples  and/or  composites  for  plotting  on  one  screen.  Data 
input  and  selection  are  accomplished  through  screens  and  pop-up  windows 
(hereafter  called  requestors).  Detailed  lists  and  descriptions  of  the  requestors  and 
input  parameters  are  presented  in  the  Procedure  Section  of  this  document. 

Output 


Results  from  composite  calculations  may  be  displayed  on  screens,  written  to  plot 
output  files  1  and  2  (default  name  PLOTDATl.OUT  and  PLOTDAT2 .OUT), 
and  displayed  via  plots.  Detailed  descriptions  of  the  screen  output  and  plots  are 
given  in  the  Procedure  section  of  this  document.  The  plot  output  files  are 
described  below. 


Plot  Output  File  1 

The  contents  and  format  of  plot  output  file  1  (default  name  PLOTDATl.OUT) 
duplicate  that  of  option  (ED:  View  Output  Data  accessible  from  the  Activity  Menu. 
Information  reported  is: 

a.  Wentworth  and  Unified  Soils  Classification  schemes  identifying 
percentage  of  the  composite’s  sand  weight  in  various  categories  (gravel, 
sand,  silt,  etc.) 

b.  Statistics  of  the  composite  calculated  by  Method  of  Moments  and  Folk 
Graphics  Measures. 
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c.  Header  information  and  percentage  by  sand  weight  of  specific  grain 
sizes  in  the  composite. 

d.  When  the  composite  is  composed  from  core  samples,  the  percentage  of 
the  total  core  length  that  each  sample  represents  is  also  provided. 


Plot  Output  File  2 

Composite  data  (header  information  and  percent  of  sand  weight  distribution  are 
written  to  plot  output  file  2  (default  name  PL0TDAT2.0UT).  The  format  of 
this  file  duplicates  that  of  sand  samples  read  from  an  external  file  or  written  to 
the  trace  output  file  with  one  exception.  A  "C"  in  line  4  of  this  file  indicates 
to  the  application  that  it  is  composite  data  rather  than  sample  data.  Data  in  this 
file  may  be  used  as  input  to  the  second  major  function  of  this  application.  Plot 
Samples/Composites  on  the  Same  Screen. 


Trace  Output  File 

Sand  samples  selected  for  composite  calculations  are  written  to  the  trace  output 
file  (default  name  TRACE. OUT).  The  format  and  contents  of  this  file  match 
exactly  the  requirements  of  input  files  for  this  application. 


Procedure 


This  application  provides  only  a  Single  Case  Mode.  The  Multiple  Case  Mode  is 
not  available.  The  Single  Case  Mode  requires  interaction  with  the  application 
through  numerous  requestors. 


°  Press  (FT)  on  the  Main  Menu  to  select  Single  Case  Mode. 

°  Fill  in  the  highlighted  input  fields  on  the  General  Specifications  screen 
(or  leave  the  default  values).  Press  (fT)  when  all  data  on  this  screen 
are  correct. 

°  Press  (F6)  on  the  Functional  Area  Menu  to  select  Littoral  Processes. 

0  Press  (F3)  on  the  Littoral  Processes  Menu  to  select  Calculation  of 
Composite  Grain-Size  Distributions. 
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Select  Unit  of  Measurement  for  Composite  Particle  Diameter 

This  item  refers  only  to  the  final  system  of  units  (phi,  millimeter,  or  American 
Society  for  Testing  Materials  (ASTM)  mesh  sizes)  in  which  the  composite 
grain-size  distribution  is  displayed  and  printed.  The  units  allowed  for  Particle 
Diameter  are: 

phi,  mm,  or  ASTM  mesh  sizes 

Table  A-4  in  Appendix  A  lists  sediment  particle  diameters  (in  phi  units,  equivalent 
millimeters,  and  ASTM  mesh  sizes)  recognized  by  this  application.  After  selecting 
the  desired  units,  press  one  of  the  following  keys  to  select  the  appropriate  action: 

[fT]  Proceed. 

[Flo]  Exit  Application. 


Application’s  Major  Activities 

This  application  provides  two  major  activities: 

(fT)  Compute  and  View  a  Composite. 

(fD  Plot  Samples/Composites  on  Same  Screen. 

(fio]  Exit  Menu. 

(fT)  Compute  and  View  a  Composite 

The  following  sections  describe  the  various  activity  menus  and  screen  requestors 
enabling  data  entry,  data  selection,  composite  calculations,  viewing  a  composite, 
and  plotting  a  composite. 


Data  Entry  Options  Menu 

This  menu  provides  two  options  for  interactive  participation  with  the  application. 
The  first  option  allows  entering  new  data  sets  and  the  second  option  allows 
editing  of  data  sets  in  an  external  file. 


[fT]  Initial  Case  Data  Entry. 

Use  this  option  to  enter  an  initial  (new)  set  of  data.  These 
data,  referred  to  as  a  case,  will  be  stored  in  a  temporary  file 
and  will  be  accessible  to  the  program  only  while  processing 
this  case.  All  data  in  the  case  are  not  automatically  written 
to  the  Trace  Output  File.  The  only  data  that  are  written  to 
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the  Trace  Output  File  are  those  identified  for  calculating  the 
composite  grain-size  characteristics.  Data  identification  is 
made  via  the  Identify  Samples  for  Composite  option. 


[Ait]  (fT)  Edit  Existing  Case  from  File:  CGS1.IN. 

Use  this  option  to  access  and  modify  data  saved  in  an  external 
file  and  to  add  additional  data.  Addition  of  data  is 
accomplished  via  the  Enter  Sample  Data  option.  Modification 
of  data  is  made  via  the  Edit  Sample  Data  option.  Additions 
and/or  modifications  are  written  to  a  temporary  file  and  are 
accessible  to  the  program  only  while  processing  this  case. 
All  new  and/or  modified  samples  are  not  automatically  written 
to  the  Trace  Output  file.  The  only  data  that  are  written  to 
the  Trace  Output  File  are  those  identified  for  calculating  the 
composite  grain-size  characteristics.  Data  identification  is 
made  via  the  Identify  Samples  for  Composite  option. 
Typically  this  data  file  has  been  saved  as  a  trace  output  file 
from  a  previous  execution  of  this  application.  The  default 
input  file  name  is  CGS1.IN,  but  other  file  names  (including 
path  name)  are  acceptable.  After  entering  the  file  name, 
press  (  enter  )  to  accept  this  file.  For  more  information  on 
files,  see  the  section  of  this  manual  entitled  "General 
Instructions  and  Information." 

NOTE:  The  file  CGS1.IN  contains  128  core  samples 
collected  in  1984  for  the  beach  nourishment  project 
at  Panama  City,  Florida. 


Activity  Menu 

The  Activity  Menu  is  a  point  from  which  all  options  for  Single  Case  data  entry, 
modification,  execution,  and  plotting  are  accessible.  The  options  are: 

(fi)  Begin  Computations. 

[F2|  Enter/Edit  Sample  Data. 

(F3)  Identify  Samples  for  Composite. 

(F4)  View  Output  Data. 

(fs|  Plot  Output  Data. 

(Fl'o)  Exit  Menu. 

Each  option  and  the  required  input  are  described  below. 
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[fT]  Begin  Computations 

Use  this  option  only  after  all  sample  data  have  been  entered  and/or  modified 
and  selected  for  computations.  Before  executing  the  composite  grain-size 
calculations,  a  requestor  (Enter  Header  Information  for  Composite)  requiring 
identification  and  commentary  parameters  specific  to  the  composite  is  displayed. 


Enter  Header  Information  for  Composite 

Enter  an  accurate  description  of  data  used  in  calculating  the  composite.  This 
information  is  helpful  for  immediate  as  well  as  future  uses  of  the  composite 
grain-size  distribution.  The  following  list  describes  parameters  required  on  the 
Enter  Header  Information  for  Composite  requestor. 

Item  Description 

Composite  Name  Unique  name  assigned  to  this  composite 

Analyzer  Person/company/agency  analyzing  the  data 

Title  Project  title 

Comment  Any  helpful  information 

When  the  header  information  has  been  entered,  press  one  of  the  following  keys 
to  select  the  next  appropriate  action: 


[fi)  Accept  Data  &  Begin  Computations. 
[fio]  Exit  Window. 


[F2|  Enter/Edit  Sample  Data 

This  option  provides  an  interactive  capability  to  enter  new  or  edit  existing  sand 
sample  data  that  are  used  for  calculating  composite  grain-size  distributions.  The 
set  of  data  that  is  entered  or  edited  is  referred  to  as  the  case.  Input  is  accomplished 
through  numerous  requestors.  A  flowchart  showing  requestors  available  under 
the  Enter/Edit  Sample  Data  option  is  shown  in  Figure  6-3-1.  The  format  and 
data  requirements  for  these  requestors  are  described  below. 
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Figure  6-3-1.  Flowchart  of  Requestors  for  Option  |F2l ,  "Enter/Edit  Sample  Data" 


When  the  ©  option  (Enter/Edit  Sample  Data)  from  the  Activity  Menu  is  selected, 
the  Enter/Edit  Sample  Data  requestor  is  displayed. 

Enter/Edit  Sample  Data 

This  requestor  provides  options  for: 

°  Entering  new  sand  sample  data  (Enter  Sample  Data). 

°  Editing  existing  sand  sample  data  (Edit  Sample  Data). 

To  select  an  option,  move  the  cursor  to  the  desired  choice  and  press  ®.  Selecting 
either  of  these  choices  will  display  requestors  for  further  input. 


Enter  Sample  Data 

This  option  allows  for  interactively  adding  new  sand  sample  data  to  an  existing 
case  or  creating  a  new  case.  Two  requestors  are  required  to  record  data.  The 
first  requestor  (Enter  Sample  Header  Data)  is  used  to  collect  header  data  and 
germane  information  for  each  sample  in  the  case.  The  second  requestor  (Enter 
Sample  Sand-Size  Distribution)  is  used  to  record  sand-size  distribution  data  for 
each  sample.  A  case  can  contain  a  maximum  of  144  samples.  These  requestors 
are  described  in  detail  below. 


Enter  Sample  Header  Data 

This  requestor  collects  header  data  and  general  information  unique  to  each  sand 
sample  in  the  case.  The  following  list  describes  parameters  on  the  Enter  Sample 
Header  Data  requestor  with  their  corresponding  units  and  range  of  data  recognized 
by  this  application: 
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Item 

Sample  Name 
Title 

Date  Collected 


Description 

Unique  name  assigned  to  this  sample  (each 
sample  must  be  uniquely  identified) 

Project  title 

Date  the  sand  sample  was  collected 


Analyzer 
Comment 
Position  on  Beach 

Type  of  Sample 


Person/company/agency  analyzing  the  data 

Any  helpful  information 

Location  where  sand  sample  was  taken 
(nearshore,  offshore,  etc.) 

Method  of  collection  of  sample  (surface,  core, 
vibracore,  etc.) 


Item 

Units 

Data  Ranee 

Profile  Number 

0 

to 

9,999 

Surface/Core  Elevation 

ft,  m 

-100.0 

to 

100.0 

Core  Length  (Core  Sample  only) 

ft,  m 

0.0 

to 

50.0 

Top  of  Sample  (Core  Sample  only) 

ft,  m 

0.0 

to 

50.0 

Bottom  of  Sample  (Core  Sample  only) 

ft,  m 

0.0 

to 

50.0 

Latitude 

0.0 

to 

9,999,999. 

Longitude 

0.0 

to 

9,999,999. 

Total  Sand  Weight 

grams 

0.0 

to 

500.0 

Particle  Diameter  Units  phi,  mm,  ASTM  mesh  size 

■  NOTE:  Particle  Diameter  units  declared  on  the  Enter  Sample 
Header  Data  requestor  identify  the  units  of  measurement  for  grain 
sizes  collected  on  the  Enter  Sample  Sand-Size  Distribution 

requestor. 


When  data  have  been  entered,  press  one  of  the  following  keys  to  select  the  next 
appropriate  action: 

[ At ,T  m  Continue  Input  (invokes  the  Enter  Sample  Sand-Size 
Distribution  requestor). 

[fT]  Accept  Data  &  Return. 

(ftp)  Return  to  Menu  (Activity  Menu). 
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Enter  Sample  Sand-Size  Distribution 

This  requestor  collects  sand  weight  in  grams  for  standard  particle  diameters  (see 
Table  A-4  in  Appendix  A).  The  standard  particle  diameters  are  displayed  as  an 
aid  for  inputting  sand  weights.  The  particle  diameter  unit  (phi,  millimeter,  or 
ASTM  mesh  size)  specified  on  the  Enter  Sample  Header  Data  requestor  determines 
the  unit  of  measurement  for  sand  weights  recorded  on  the  Enter  Sample  Sand-Size 
Distribution  requestor,  A  maximum  of  56  sand  weights  can  be  entered.  The 
range  of  sand  weight  values  allowed  by  this  application  is  listed  below. 

Item  Units  Data  Range 

Sand  Weight  grams  -1.0  to  3000.0 


NOTE:  A  sand  weight  of  -1.0  indicates  to  the  application  that 
NO  weight  was  recorded  for  the  associated  grain  size.  This 
allows  sand  distributions  to  be  entered  independently  of  the 
sieve  interval.  Thus,  mixed  and/or  well-sorted  sand  populations 
may  be  recorded. 


LIMITATION:  Sediment  particle  diameters  accepted  by  this 
application  are  listed  in  Table  A-4  in  Appendix  A. 


When  finished  entering  sand  weights  on  this  requestor ,  press  one  of  the  following 
keys  to  select  the  next  appropriate  action: 

[alt ](fi)  Continue  Input. 

NOTE:  A  maximum  of  28  particle  diameters  and  associated 
sand  weights  can  be  displayed  and  entered  on  one  screen. 

To  display  the  remaining  28  standard  particle  diameters  and 
enter  corresponding  sand  weights,  press  (alt)  (fT).  After 
all  sand  weights  have  been  entered,  press  (alt)  0)  again  to 
invoke  the  Enter  Sample  Header  Data  requestor  for  entering 
data  for  the  next  sand  sample. 

(Fp  Accept  Data  &  Return. 

[fio]  Return  to  Menu  (to  Activity  Menu). 
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Edit  Sample  Data 

This  option  allows  for  interactively  editing  sand  sample  data.  Three  requestors 
guide  the  user  through  the  editing  procedure.  The  first  requestor  (Tag  Sample 
Names  for  Editing)  provides  an  easy  process  to  identify  samples  for  editing.  The 
second  requestor  (Edit  Sample  Header  Data)  is  used  to  edit  header  data  and 
general  information  for  each  sample  selected.  The  third  requestor  (Edit  Sample 
Sand-Size  Distribution)  is  used  to  edit  sand-size  distribution  data  for  each  sample. 
These  requestors  are  described  in  detail  below. 


Tag  Sample  Names  for  Editing 

This  requestor  allows  identifying  samples  for  editing  by  tagging  the  name  of  the 
sample.  All  sample  names  in  the  case  are  displayed  as  an  aid  for  identification 
and  tagging.  To  select  and  tag  a  sample,  move  the  cursor  to  the  desired  choice 
and  press  ©.  Continue  this  procedure  until  all  desired  samples  are  tagged. 

When  selection  and  tagging  are  complete,  press  one  of  the  following  keys  to 
select  the  next  appropriate  action: 

[  alt  )(Fl)  More  Input. 

NOTE:  A  maximum  of  60  sample  names  are  displayed  on 
one  screen.  If  more  than  60  samples  are  in  the  case,  press 
[alt]  @  to  display  more  sample  names. 

(FT)  Accept  Data,  Exit  Window  (invokes  the  Edit  Sample  Header 
Data  requestor  to  begin  the  editing  process). 

[fio)  Exit  Window  (Activity  Menu). 


Edit  Sample  Header  Data 

This  requestor  allows  editing  the  header  data  and  general  information  unique  to 
the  tagged  sand  samples.  The  following  list  describes  the  specific  parameters 
on  the  Edit  Sample  Header  Data  requestor  that  can  be  edited,  with  their 
corresponding  units  and  range  of  data  recognized  by  this  application: 
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Item 

Sample  Name 
Title 

Date  Collected 
Analyzer 
Comment 
Position  on  Beach 

Type  of  Sample 


Description 

Unique  name  assigned  to  this  sample  (each 
sample  must  be  uniquely  identified) 

Project  title 

Date  the  sand  sample  was  collected 
Person/company/agency  analyzing  the  data 
Any  helpful  information 
Location  where  sand  sample  was  taken 
(nearshore,  offshore,  etc.) 

Method  of  collection  of  sample  (surface,  core, 
vibracore,  etc.) 


Item 

Profile  Number 

Surface/Core  Elevation 

Core  Length  (Core  Sample  only) 

Top  of  Sample  (Core  Sample  only) 

Bottom  of  Sample  (Core  Sample  only) 

Latitude 

Longitude 

Total  Sand  Weight 


Units  Data  Ranee 


0 

to 

9,999 

ft,  m 

-100.0 

to 

100.0 

ft,  m 

0.0 

to 

50.0 

ft,  m 

0.0 

to 

50.0 

ft,,  m 

0.0 

to 

50.0 

0.0 

to 

9,999,999. 

0.0 

to 

9,999,999. 

grams 

0.0 

to 

500.0 

Particle  Diameter  Units  phi,  mm,  ASTM  mesh  size 

NOTE:  Particle  diameter  units  declared  on  the  Edit  Sample  Header 
Data  requestor  determine  the  units  of  measurement  that  will  appear 
on  the  Edit  Sample  Sand-Size  Distribution  requestor. 

When  data  have  been  edited,  press  one  of  the  following  keys  to  select  the  next 
appropriate  action: 


(alt ](fi)  Continue  Input  (invokes  the  Edit  Sample  Sand-Size 
Distribution  requestor  to  continue  the  editing  process). 

(fT)  Accept  Data  &  Return. 

(fio]  Return  to  Menu  (Activity  Menu). 
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Edit  Sample  Sand-Size  Distribution 

This  requestor  displays  sand  weights  in  grams  for  standard  particle  diameters  for 
the  tagged  sand  samples.  The  standard  particle  diameters  are  displayed  as  an 
aid  for  inputting  sand  weights.  The  particle  diameter  unit  (phi,  millimeter,  or 
ASTM  mesh  size)  specified  on  the  Edit  Sample  Header  Data  requestor  determines 
the  unit  of  measurement  for  sand  weights  recorded  on  the  Edit  Sample  Sand-Size 
Distribution  requestor.  A  maximum  of  56  sand  weights  can  be  entered.  The 
range  of  sand  weight  values  allowed  by  this  application  is  listed  below. 

Item  Units  Data  Range 

Sand  Weight  grams  -1.0  to  3,000.0 

NOTE:  A  sand  weight  of  -1.0  indicates  to  the  application  that 
NO  weight  was  recorded  for  the  associated  grain  size.  This 
allows  sand  distributions  to  be  entered  independently  of  the 
sieve  interval.  Thus,  mixed  and/or  well-sorted  sand  populations 
may  be  recorded. 


LIMITATION:  Sediment  particle  diameters  accepted  by  this 
application  are  listed  in  Table  A-4  in  Appendix  A. 


When  finished  editing  sand  weights  on  this  requestor ,  press  one  of  the  following 
keys  to  select  the  next  appropriate  action: 


(  alt  )(fT)  Continue  Input. 

NOTE:  A  maximum  of  28  particle  diameters  and  associated 
sand  weights  can  be  displayed  and  recorded  on  one  screen. 
To  display  the  remaining  standard  particle  diameters  and 
corresponding  sand  weights,  press  [alt )  (fi).  After  all  sand 
weights  have  been  edited,  press  (alt)  (ED  again  to  invoke 
the  Edit  Sample  Header  Data  requestor.  This  will  display 
recorded  data  for  the  next  tagged  sand  sample. 

(fi)  Accept  Data  &  Return. 

(FlQ)  Return  to  Menu  (Activity  Menu). 
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(F3)  Identify  Samples  for  Composite 

This  option  provides  an  interactive  capability  to  identify  and  select  data  samples 
from  the  case  for  use  in  calculating  the  composite  grain-size  distribution. 
Selection  of  the  data  is  accomplished  through  numerous  requestors.  A  flowchart 
depicting  requestors  available  via  the  F3:  Identify  Samples  for  Composite  option 
is  shown  in  Figure  6-3-2.  The  samples  selected  from  the  case  via  this  option 
are  written  to  the  Trace  Output  File  (default  name  TRACE. OUT)  and  then  used 
in  the  composite  grain-size  calculations.  The  format  and  data  requirements  for 
these  requestors  are  described  below. 


Figure  6-3-2.  Flowchart  of  Requestors  for  Option  (£2) ,  "Identify  Samples  for  Composite" 


When  the  F3:  Identify  Samples  for  Composite  option  is  selected,  the  Select  Type 
of  Samples  for  Composite  requestor  is  displayed. 

Select  Type  of  Samples  for  Composite 

This  requestor  provides  three  options  for  identifying  the  type  of  samples  that 
will  make  up  the  data  set  used  in  the  composite  grain-size  calculations.  The 
options  are: 

0  Surface  Samples. 

°  Core  Samples. 

°  All  Samples. 

To  select  an  option,  move  the  cursor  to  the  desired  choice  and  press  0.  Selecting 
either  Surface  Samples  or  Core  Samples  will  display  more  requestors  for  further 
input.  Selecting  All  Samples  requires  no  further  requestors. 
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Surface  Samples 

When  the  Surface  Samples  option  is  selected,  the  Select  Surface  Samples  By 
requestor  is  displayed.  This  requestor  invokes  other  requestors  (Figure  6-3-3) 
that  collect  choices  and  input  to  determine  the  data  set  for  composite  grain-size 
calculations. 


Figure  6-3-3.  Flowchart  of  Requestors  for  the  Surface  Samples  Option 


The  Select  Surface  Samples  By  requestor  provides  four  choices  for  selecting 
samples.  These  choices  are: 

°  Profile  Line  Number(s) 

°  A  Range  of  Elevations 
°  Both  Range  of  El.  &  Profile  No. 

°  Individual  Surface  Name(s) 

Make  a  selection  by  moving  the  cursor  to  the  desired  choice  and  pressing  ©. 
Each  choice  will  display  more  requestors  for  identifying  desired  surface  samples. 
The  format  and  data  requirements  of  resulting  requestors  are  described  below. 
After  samples  are  identified  and  selected,  the  program  returns  to  the  Select 
Surface  Samples  By  requestor.  To  accept  samples  that  were  selected,  press  (ED. 
The  program  now  writes  this  data  set  to  the  Trace  Output  File  (default  name 
TRACE. OUT)  and  these  data  are  used  in  the  composite  grain-size  calculations. 
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Profile  Line  Number(s) 

This  option  allows  selecting  samples  by  a  specific  number  assigned  to  a  profile 
line.  Choosing  this  option  invokes  the  Identify  Profiles  By  requestor.  The  choices 
offered  by  this  requestor  are: 

°  A  Range  of  Profiles, 

8  Individual  Profile(s). 


Select  one  of  the  two  choices  by  moving  the  cursor  to  the  desired  choice  and 
pressing  (3.  Both  choices  display  more  requestors  that  ultimately  identify  a  set 
of  surface  samples  for  the  composite  data  set.  These  requestors  are  described 
below. 


A  Range  of  Profiles 

This  choice  invokes  the  Enter  Profile  Range  requestor ,  which  allows  selecting 
samples  that  fall  within  a  certain  range  of  profile  numbers. 

The  range  of  profile  number  values  allowed  by  this  application  is  given  below: 

Item  Data  Range 

Minimum  Profile  Number  0  to  9999 

Maximum  Profile  Number  0  to  9999 

When  the  range  of  profile  numbers  has  been  entered,  press  one  of  the  following 
keys  to  select  the  next  appropriate  action: 

(Ft)  Accept  Data  &  Exit  Window. 

[ALT )(fio]  Exit  Window. 
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Individual  Profile(s) 

This  choice  invokes  the  Tag  Surface  Sample  Profile  Numbers  for  Composite 
requestor,  which  allows  selecting  samples  by  tagging  the  desired  profile  line 
number(s).  All  sample  profile  line  numbers  in  the  case  are  displayed  as  an  aid 
to  identification  and  tagging.  To  select  and  tag  a  sample,  move  the  cursor  to 
the  desired  choice  and  press  ©.  Continue  this  procedure  until  all  desired  samples 
are  tagged. 

When  selection  and  tagging  are  complete,  press  one  of  the  following  keys  to 
select  the  next  appropriate  action: 

[alt)[fT)  More  Input. 

NOTE:  A  maximum  of  60  sample  names  are  displayed  on 
one  screen.  If  more  than  60  samples  are  in  the  case,  press 
|alt[  (FT)  to  display  more  sample  names. 

(fT)  Accept  Data,  Exit  Window. 

[fio]  Exit  Window. 


A  Range  Of  Elevations 

This  option  allows  selecting  only  those  samples  that  fall  within  a  certain  range 
of  elevations.  Choosing  this  option  invokes  the  Enter  Elevation  Range  requestor. 

The  units  and  range  of  elevation  values  allowed  by  this  application  are  given 
below: 

Item  Units  Data  Range 

Minimum  Elevation  ft,  m  -100.0  to  100.0 

Maximum  Elevation  ft,  m  -100.0  to  100.0 

When  the  range  of  elevations  has  been  entered,  press  one  of  the  following  keys 
to  select  the  next  appropriate  action: 

[fT]  Accept  Data  &  Exit  Window. 

[alt ](fio)  Exit  Window. 
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Both  Range  of  El.  &  Profile  No. 

This  option  allows  selecting  samples  that  fall  within  a  certain  range  of  elevations 
and  for  specific  profile  number(s).  A  sampie  must  meet  both  elevation,  and 
profile  number  criteria  to  be  selected  for  the  data  set.  Selection  of  samples  is 
made  through  numerous  requestors.  The  first  requestor  that  appears  is  the  Enter 
Elevation  Range  requestor  that  was  described  earlier.  After  the  maximum  and 
minimum  elevations  have  been  entered,  the  Identify  Profiles  By  requestor  is 
invoked  by  responding  yes  to  the  question  To  Profile  Screens'!  Selection  of 
samples  can  then  continue  through  two  more  requestors. 

°  See  A  Range  of  Profiles  (described  earlier). 

°  See  Individual  Profile(s)  (described  earlier). 


Individual  Surface  Name(s) 

This  option  invokes  the  Tag  Surface  Samples  Names  for  Composite  requestor , 
which  allows  selecting  samples  by  tagging  the  desired  surface  sample  name(s). 
All  sample  names  in  the  case  are  displayed  as  an  aid  for  identification  and 
tagging.  To  select  and  tag  a  surface  sample,  move  the  cursor  to  the  desired  name 
and  press  S.  Continue  this  procedure  until  all  desired  samples  are  tagged. 

When  selection  and  tagging  are  complete,  press  one  of  the  following  keys  to 
select  the  next  appropriate  action: 

f  alt ][fi)  More  Input. 

NOTE:  A  maximum  of  60  sample  names  are  displayed  on 
one  screen.  If  more  than  60  samples  are  in  the  case,  press 
[alt]  (□)  to  display  more  sample  names. 

FT]  Accept  Data,  Exit  Window. 

[fio]  Exit  Window. 
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Core  Samples 

When  the  Core  Samples  option  is  selected,  the  Select  Core  Samples  By  requestor 
is  displayed.  This  requestor  invokes  other  requestors  (Figure  6-3-4)  that  collect 
choices  and  input  to  determine  the  data  set  for  composite  grain-size  calculations. 


Figure  6-3-4.  Flowchart  of  Requestors  for  the  Core  Samples  Option 


The  Select  Core  Samples  By  requestor  provides  five  choices  for  selecting  samples. 
These  choices  are: 

0  Individual  Core  Name(s) 

0  A  Range  of  Elevations 
°  Both  Range  of  El.  &  Core  Name 
°  Profile  Line  Number(s) 

°  Both  Range  of  El.  &  Profile  No. 

Make  a  selection  by  moving  the  cursor  to  the  desired  choice  and  pressing  0. 
Each  choice  displays  more  requestors  for  identifying  desired  core  samples.  The 
format  and  data  requirements  of  resulting  requestors  are  described  below.  After 
samples  are  identified  and  selected,  the  program  returns  to  the  Select  Core 
Samples  By  requestor.  To  accept  samples  that  were  selected,  press  (D).  The 
program  now  writes  this  data  set  to  the  Trace  Output  File  (default  name 
TRACE. OUT)  and  these  data  are  used  in  the  composite  grain-size  calculations. 
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Individual  Core  Name(s) 

This  option  invokes  the  Tag  Core  Samples  Names  for  Composite  requestor,  which 
allows  selecting  samples  by  tagging  the  desired  core  name(s).  All  sample  names 
in  the  case  are  displayed  as  an  aid  for  identification  and  tagging.  To  select  and 
tag  a  core  sample,  move  the  cursor  to  the  desired  name  and  press  ®.  Continue 
this  procedure  until  all  desired  samples  are  tagged. 

When  selection  and  tagging  are  complete,  press  one  of  the  following  keys  to 
select  the  next  appropriate  action: 

[  alt  ](fT)  More  Input. 

NOTE:  A  maximum  of  60  sample  names  are  displayed  on 
one  screen.  If  more  than  60  samples  are  in  the  case,  press 
(alt)  (ED  to  display  more  sample  names. 

[fi]  Accept  Data,  Exit  Window. 

[Flo]  Exit  Window. 


A  Range  of  Elevations 

This  option  allows  selecting  only  those  samples  that  fall  within  a  certain  range 
of  elevations.  Choosing  this  option  invokes  the  Enter  Elevation  Range  requestor. 

The  units  and  range  of  elevation  values  allowed  by  this  application  are  given 
below: 


Item 

Units 

Data  Ranee 

Minimum  Elevation 

ft,  m 

-100.0  to  100.0 

Maximum  Elevation 

ft,  m 

-100.0  to  100.0 

When  the  range  of  elevations  has  been  entered,  press  one  of  the  following  keys 
to  select  the  next  appropriate  action: 

(fT)  Accept  Data  &  Exit  Window. 

[alt )(fio]  Exit  Window. 
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Both  Range  of  Ei.  &  Core  Name 

This  option  allows  selecting  samples  that  fall  within  a  range  of  elevations  and 
for  specific  core  name(s).  A  sample  must  meet  both  elevation  and  name  criteria 
to  be  selected  for  the  data  set.  Selection  of  samples  is  made  through  two  requestors. 

0  Enter  Elevation  Range. 

0  Tag  Core  Samples  for  Composite. 

The  first  requestor  displayed  is  the  Enter  Elevation  Range  requestor,  which  was 
described  earlier  in  the  section  titled  A  Range  of  Elevations.  After  maximum 
and  minimum  elevations  have  been  entered,  the  Tag  Core  Sample  Names  for 
Composite  requestor  (described  earlier  in  the  section  titled  Individual  Core 
Name(s))  is  invoked  by  responding  yes  to  the  question  To  Core  Name  Screens ? 

Profile  Line  Number(s) 

This  option  allows  selecting  samples  by  a  specific  number  assigned  to  a  profile 
line.  Choosing  this  option  invokes  the  Identify  Profiles  By  requestor.  The  choices 
offered  by  this  requestor  are: 

0  A  Range  of  Profiles. 

0  Individual  Profile(s). 

Select  one  of  the  two  choices  by  moving  the  cursor  to  the  desired  choice  and 
pressing  ©.  Both  choices  display  more  requestors  that  ultimately  identify  a  set 
of  core  samples  for  the  composite  data  set.  These  requestors  are  described  below. 

A  Range  of  Profiles 

This  choice  invokes  the  Enter  Profile  Range  requestor  which  allows  selecting 
samples  that  fall  within  certain  profile  numbers. 

The  range  of  profile  number  values  allowed  by  this  application  is  given  below: 

Item  Data  Ranae 

Minimum  Profile  Number  0  to  9999 

Maximum  Profile  Number  0  to  9999 

When  the  range  of  profile  numbers  has  been  entered,  press  one  of  the  following 
keys  to  select  the  next  appropriate  action: 

©  Accept  Data  &  Exit  Window. 

[altXfio]  Exit  Window. 
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Individual  Profilef  s ) 

This  choice  invokes  the  Tag  Core  Sample  Profile  Numbers  for  Composite 
requestor,  which  allows  selecting  samples  by  tagging  the  desired  profile  line 
number(s).  All  sample  profile  line  numbers  in  the  case  are  displayed  as  an  aid 
to  identification  and  tagging.  To  select  and  tag  a  sample,  move  the  cursor  to 
the  desired  choice  and  press  0.  Continue  this  procedure  until  all  desired  samples 
are  tagged. 

When  selection  and  tagging  are  complete,  press  one  of  the  following  keys  to 
select  the  next  appropriate  action: 

[  ALT  ](fT]  More  Input. 

NOTE:  A  maximum  of  60  sample  names  are  displayed  on 
one  screen.  If  more  than  60  samples  are  in  the  case,  press 
[alt )  JfT)  to  display  more  sample  names. 

(fT)  Accept  Data,  Exit  Window. 

[fio]  Exit  Window. 


Both  Range  of  El.  &  Profile  No. 

This  option  allows  selecting  samples  that  fall  within  certain  elevations  and  for 
specific  profile  number(s).  A  sample  must  meet  both  elevation  and  profile 
number  criteria  to  be  selected  for  the  data  set.  Selection  of  samples  is  made 
through  numerous  requestors.  The  first  requestor  that  appears  is  the  Enter 
Elevation  Range  requestor  described  earlier.  After  the  maximum  and  minimum 
elevations  have  been  entered,  the  Identify  Profiles  By  requestor  is  invoked  by 
responding  yes  to  the  question  To  Profile  Screens' ?  Selection  of  samples  can 
then  continue  through  two  more  requestors. 

See  A  Range  of  Profiles  (described  earlier). 

°  See  Individual  Profile(s)  (described  earlier). 
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All  Samples 

Selecting  All  Samples  requires  no  further  requestors,  and  all  samples  in  the  case 
make  up  the  data  set  used  for  the  composite  grain-size  calculations.  The  program 
then  writes  this  data  set  to  the  Trace  Output  file  (default  name  TRACE.OUT). 
This  same  data  set  is  used  to  determine  properties  of  the  composite  when  the 
application  is  executed. 


SUGGESTION: 

After  an  initial  or  new  set  of  sample  data  has  been  entered,  it 
is  suggested  that  the  AH  Samples  choice  be  selected  to  save  all 
the  data  that  were  entered.  This  file  can  then  be  recalled,  and 
desired  samples  from  it  can  be  selected  for  the  composite 
calculations. 


(F4)  View  Output  Data 

This  option  allows  for  viewing  the  results  of  this  application,  which  are  displayed 
on  two  screens. 

9  The  first  screen  displays  percentage  by  weight  (for  the  composite)  of 
the  various  sediment  categories  on  The  Wentworth  and  Unified  Soils 
classification  schemes.  This  screen  also  displays  the  following  statistics 
of  the  composite  sample  calculated  by  Method  of  Moments  and  Folk 
Graphics  Measures. 

®  Median  Diameter. 

°  Mean  Diameter. 

*  Standard  Deviation. 

"  Skewness. 

"  Kurtosis. 

6  The  second  screen  displays  parameters  for  the  composite. 

9  Header  information. 

9  Percent  weight  distribution. 
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[fs)  Plot  Output  Data 

This  application  generates  three  plots.  The  plots  may  be  accessed  from  the 
Composite  Grain-Size  Distribution  Plot  Selection  Menu  which  is  displayed  when 
the  Plot  Output  Data  (ED)  option  is  requested.  To  access  a  plot,  move  the  cursor 
(using  the  arrow  keys)  to  the  desired  plot  and  press  (fi).  (Appendix  C  describes 
options  to  customize  plots.)  Available  plots  are: 

°  Frequency  Weight  Percent. 

°  Cumulative  Weight  Percent. 

°  Probability  Weight  Percent. 

°  ALL  PLOTS. 

NOTE:  This  option  will  make  all  the  plots  available  for  viewing. 
Use  the  NEXT  option  of  the  graphics  package  (Appendix  C) 
to  view  each  plot  successively. 

EXIT  MENU. 
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[F2]  Plot  Samples/Composites  on  the  Same  Screen 

This  option  from  the  Application’s  Major  Activities  menu  is  used  to  plot  individual 
samples,  composites,  or  a  combination  of  individual  samples  and  composites.  As 
many  as  five  may  be  plotted  on  a  screen.  The  following  sections  describe  various 
screen  requestors  enabling  data  entry,  selection,  and  plotting. 

Read  Data  in  External  File 

Use  .this  option  to  read  sample  and/or  composite  data  saved  in  an  external  file. 
Normally  the  data  file  is  created  with  a  text  editor,  or  saved  as  a  trace  file 
(default  name  TRACE.OUT)  or  as  plot  output  file  2  (default  name 
PL0TDAT2.0UT)  from  a  previous  execution  of  this  application.  The  format 
and  contents  of  a  trace  file  and  a  plot  output  file  2  produced  by  this  application 
match  exactly  the  requirements  of  this  input  file.  The  default  input  file  name 
is  CGSPLT.IN  but  other  file  names  (including  path  name)  are  acceptable.  After 
entering  the  file  name,  press  [  enter  ]  to  accept  this  file.  For  more  information 
on  files,  see  the  section  of  this  manual  entitled  "General  Instructions  and 
Information." 

Press  one  of  the  following  keys  to  select  the  next  appropriate  action: 

[alt )[fio]  Accept  Data  &  Exit  (after  reading  the  data  file,  invoke 
Tag  Names  for  Plotting  requestor). 

[ft)  Exit  Window, 

Tag  Names  for  Plotting 

This  requestor  allows  identifying  sample  and/or  composites  for  plotting  by  tagging 
the  name.  All  names  in  the  file  are  displayed  as  an  aid  for  identification  and 
tagging.  To  select  and  tag  a  name,  move  the  cursor  to  the  desired  choice  and 
press  ©.  Continue  this  procedure  until  all  desired  names  (maximum  of  five) 
are  tagged.  (Allowing  more  than  five  on  a  plot  may  produce  a  cluttered  display.) 

When  selection  and  tagging  are  complete,  press  one  of  the  following  keys  to 
select  the  next  appropriate  action: 

f ALT ](ft)  More  Input. 

NOTE:  A  maximum  of  60  composite  and/or  sample  names 
are  displayed  on  one  screen.  If  more  than  60  names  are  in 
the  file,  press  [alt!  (ft)  to  display  more  names. 

[ft)  Accept  Data,  Exit  Window  (invokes  the  Enter  Title  for  Plots 
requestor). 

[fio]  Exit  Window. 
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Enter  Title(s)  for  Plots 

The  following  list  describes  parameters  on  the  Enter  Title(s)  for  Plot  requestor. 


Item  Description 

Title  1  Text  displayed  on  the  first  title  line  of  the  plot  (a  maximum  of  60 
characters). 

Title  2  Text  displayed  on  the  second  title  line  of  the  plot  (a  maximum  of 
60  characters). 

When  text  for  the  title(s)  has  been  entered,  press  one  of  the  following  keys  to 
select  the  next  appropriate  action: 

[fI)  Accept  Data  &  Begin  Plotting  (invokes  the  Plot  Selection 
Menu  requestor). 

(alt )[fio)  Exit  Window. 

Plot  Selection  Menu 


This  option  provides  a  visual  comparison  of  the  selected  data.  Three  plotting 
options  are  available: 


°  Frequency  Weight  Percent. 

°  Cumulative  Weight  Percent. 

0  Probability  Weight  Percent. 

°  ALL  PLOTS. 

NOTE:  This  option  will  make  all  the  plots  available  for  viewing. 
Use  the  NEXT  option  of  the  graphics  package  (Appendix  C) 
to  view  each  plot  successively. 

°  EXIT  MENU. 


To  access  a  plot,  move  the  cursor  (using  the  arrow  keys)  to  the  desired  plot  and 
press  !H).  (Appendix  C  describes  options  to  customize  plots.) 
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Application  Limitations  and  Error  Provisions 

Provisions  are  available  for  correcting  input  data  errors  detected  by  the  program. 
If  an  error  in  a  sample  is  encountered,  a  message  is  displayed  at  the  bottom  of 
the  screen.  This  message,  while  terse,  is  usually  enough  to  identify  which  sample 
and  field  are  causing  the  error.  Errors  must  be  corrected  before  a  sample  is 
selected  for  computing  or  plotting.  Use  the  Edit  Sample  Data  option  to  make 
corrections. 


A  limitation  of  this  application  is  that  it  accepts  only  specific  particle  diameters 
in  phi  units,  millimeters,  or  ASTM  mesh  sizes.  These  particle  diameters  are 
listed  in  Table  A-4  of  Appendix  A. 
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Example  Problem 

This  example  will  demonstrate  how  to  interactively  enter  an  initial/new  case  of 
sand  sample  data,  save  it  in  the  Trace  Output  File,  execute  the  computations, 
and  describe  output  options. 


Input 

The  input  for  this  example  consists  of  entering  germane  identification 
characteristics  and  sand  weights  for  sand  samples  collected  from  a  core  taken  in 
Panama  City,  Florida.  Since  this  is  an  initial/new  data  case,  it  is  suggested  that 
the  data  be  saved  in  a  file.  Therefore,  it  is  required  that  the  default  name 
(TRACE.OUT)  for  the  Trace  Output  File  be  renamed  at  the  time  the  General 
Data  Specifications  screen  is  displayed.  (This  is  the  second  screen  displayed 
when  the  ACES  Program  is  started.)  Rename  the  Trace  Output  File  to  CGSEX.IN. 
Now  proceed  to  the  Calculation  of  Composite  Grain-Size  Distributions 
application. 


(F2]  Enter/Edit  Sample  Data 

This  example  consists  of  entering  data  for  two  samples  collected  from  a  core 
boring  taken  in  Panama  City,  Florida,  in  1984. 

First  Sample 

Enter  Sample  Header  Data 

Item 

Sample  Name 
Title 

Date  Collected 
Analyzer 
Comment 
Profile  Number 
Surface/Core  Elevation 
Surface/Core  Elevation  Units 
Core  Length 


Value 
2-84  1 

Panama  City  Beach  Nourishment 
1984 

CEWES-GL 

1st  of  2  samples  from  boring 
0 

-38. 

Feet 

19.4 
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Core  Length  Units 

Top  of  Sample 

Top  of  Sample  Units 

Bottom  of  Sample 

Bottom  of  Sample  Units 

Latitude 

Longitude 

Position  on  Beach 

Type  of  Sample 

Total  Sand  Weight 

Particle  Diameter  Units 


Feet 

0.0 

Feet 

18.1 


Feet 

1606792  (state  plane  coordinate  system) 

406465  (state  plane  coordinate  system) 

Offshore 

Vibracore 

72.519  grams 

PHI 


Enter  Sample  Sand-Size  Distribution 


Particle  Diameter 
(phi) 


Sand  Weight 
(grams) 


0.75 

1.00 

1.25 

1.50 

1.75 
2.00 

2.25 

2.50 

2.75 
3.00 

3.25 

3.50 

3.75 
4.00 


0.000 

2.498 

0.606 

0.984 

2.195 

3.179 

7.721 

11.431 

16.805 

17.184 

5.677 

3.028 

0.984 

0.227 
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Second  Sample 

Enter  Sample  Header  Data 

Item 

Value 

Sample  Name 

2-84  2 

Title 

Panama  City  Beach  Nourishment 

Date  Collected 

1984 

Analyzer 

CEWES-GL 

Comment 

2nd  of  2  samples  from  boring 

Profile  Number 

0 

Surface/Core  Elevation 

-38. 

Surface/Core  Elevation  Units  Feet 

Core  Length 

19.4 

Core  Length  Units 

Feet 

Top  of  Sample 

18.1 

Top  of  Sample  Units 

Feet 

Bottom  of  Sample 

19.4 

Bottom  of  Sample  Units 

Feet 

Latitude 

1606792  (state  plane  coordinate  system) 

Longitude 

406465  (state  plane  coordinate  system) 

Position  on  Beach 

Offshore 

— 

Type  of  Sample 

Vibracore 

Total  Sand  Weight 

37.706  grams 

Particle  Diameter  Units 

PHI 

Enter  Sample  Sand-Size  Distribution 

Particle  Diameter 

Sand  Weight 

(phi) 

(grams) 

0.75 

0.000 

1.00 

5.112 

1.25 

1.595 

1.50 

2.908 

1.75 

5.065 

2.00 

5.090 

2.25 

6.425 

2.50 

3.283 

2.75 

3.517 

3.00 

2.204 

3.25 

0.985 

3.50 

0.281 

3.75 

0.328 

4.00 

0.094 
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[F3]  Identify  Samples  for  Composite 

After  the  sample  data  have  been  entered,  they  need  to  be  saved  in  a  file  that 
can  be  edited  and  used  later.  The  procedure  is  outlined  below. 

1.  At  the  main  activity  menu,  press  EH. 

2.  Move  cursor  to  Core  Sample  and  press  0. 

3.  Move  cursor  to  Individual  Core  Name(s)  and  press  0. 

4.  Move  cursor  to  each  name  and  press  ©. 

5.  Press  (ED  (Accept  Data  &  Exit  Window). 

6.  Press  0  (Accept  Data  &  Exit). 


(fT)  Begin  Computations 

The  data  have  now  been  identified  and  tagged,  and  computations  can  begin. 

1.  Press  ©  at  the  main  activity  menu  to  enter  header  information  for 
the  composite. 


2.  Enter  header  information  for  composite. 


Item 

Composite  Name 

Analyzer 

Title 

Comment 


Value 

Panama,  FL 
CEWES-CERC 

Example  for  ACES  User’s  Guide 
This  is  a  Composite  of  Data  from  the  File 
CGSEX.IN 


3.  Press  0  (Accept  Data  &  Begin  Computations). 

The  file  CGSEX.IN  is  now  created  and  saved  and  computations  are 
started. 
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Output 

Results  from  this  application  are  displayed  on  two  screens,  written  to  plot  output 
files  1  and  2  (default  names  PLOTDAT1  .OUT  and  PL0TDAT2.0UT),  and 
displayed  on  three  plots. 


Screen  Output 

From  the  Activity  Menu,  press  (Ed)  (View  Output  Data)  to  display  the  output. 
The  first  screen  (Figure  6-3-5)  displays  percentage  by  weight  (for  the  composite) 
of  the  various  sediment  categories  on  the  Wentworth  and  Unified  Soils 
classification  schemes.  This  screen  also  displays  statistics  of  the  composite  sample 
calculated  by  Method  of  Moments  and  Folk  Graphics  Measures.  The  second 
screen  (Figure  6-3-6)  displays  header  information  and  percentage  by  weight  of 
specific  grain  sizes  for  the  composite. 


Method 

Gravel 

Silt 

Clay 

Coarse 

Medium 

Fine 

Wentworth 

0.00 

4.12 

11.71 

84.17 

0.00 

0.00 

Unified 

0.00 

0.00 

5,19 

94.51 

0.31 

0.00 

Standard  Statistics 

Method  of  MomentB 

Folk  Graphic  Measures 

Grain  Size 

Median  Diameter 

2.59  phi 

0.166  mm 

Mean  Diameter 

2.49  phi 

2.52  phi 

0.179  mm 

Standard  Deviation 

0.58  phi 

0.56  phi 

Skewness 

-0.90 

-0.27 

Kurtosis 

3.98 

1.29 

Figure  6-3-5.  First  Screen  Output  for  Example  Problem 


Composite  of  Grain-Size  Distributions 

Composite  Title  Date  Analyzed 

Panama,  FL  Example  for  ACES  User's  Guide  07/02/92 

Analyzer  Comment  Total  Weight 

CEWES-CERC  This  is  a  composite  of  Data  from  File  CGSEX.IN  100.00 

Type  of  Samples  Samples  in  Composite  Top  of  Composite  Bottom  of  Composite 


Offshore  2  0.00  feet  0.00  feet 


ASTM 

MM 

PHI 

Weight 

ASTM 

MM 

PHI 

Weight 

ASTM 

MM 

PHI 

Weight 

MESH 

Size 

Size 

(*} 

MESH 

Size 

Size 

(56) 

MESH 

Size 

Size 

(96) 

30.00 

0.59 

0.75 

0.000 

35.00 

0.50 

1.00 

4.122 

40.00 

0.42 

1.25 

1.063 

45.00 

0.35 

1.50 

1.783 

50.00 

0.30 

1.75 

3.724 

60.00 

0.25 

2.00 

5.140 

70.00 

0.21 

2.25 

11.075 

80.00 

0.177 

2.50 

15.290 

100.00 

0.149 

2.75 

22.245 

120.00 

0.125 

3.00 

22.500 

140.00 

0.105 

3.25 

7.479 

170.00 

0.088 

8.5 

3.946 

200.00 

0.074 

3.75 

1.324 

230.00 

.0625 

4.00 

0.309 

Figure  6-3-6.  Second  Screen  Output  for  Example  Problem 
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Plot  Output  File  1 

This  file  (default  name  PLOTDATl.OUT)  contains  the  following  composite 
information: 

a.  Wentworth  and  Unified  Soils  Classification  schemes  identifying 
percentage  of  the  composite’s  sand  weight  in  various  categories  (gravel, 
sand,  silt,  etc.) 

b.  Statistics  of  the  composite  calculated  by  Method  of  Moments  and  Folk 
Graphics  Measures. 

c.  Header  information  and  percentage  by  sand  weight  of  specific  grain 
sizes  in  the  composite. 

d.  When  the  composite  is  composed  of  core  samples,  the  percentage  of 
the  total  core  length  that  each  sample  represents  is  also  provided. 

Table  6-3-1  is  a  listing  of  plot  output  file  1  for  this  example. 

Table  6-3-1 

Listing  of  Plot  Output  File  1  for  Example  Problem 


Calculation  of  Composite  Grain-Sire  Distribution 
Sample:  2-84  1  represents  93.3%  of  the  core 
Sample:  2-84  2  represents  6.7%  of  the  core 
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SIZE  CLASSIFICATION: 
(By  Percent  Weight) 

Gravel 

Coarse 

Sand 

Medium 

Fine 

Silt 

Clay 

Wentworth 

0.00 

4.12 

11.71 

84.17 

0.00 

0.00 

Unified 

0.00 

0.00 

5.19 

94.51 

0.31 

0.00 

STANDARD  STATISTICS: 


Method  of  Moments  Folk  Graphic  Measures  Grain  Sire 


Median  Diameter 
Mean  Diameter 
Standard  Deviation 
Skewness 
Kurtosis 


2.49  phi 
0.58  phi 
-0.90 
3.98 


2.59 

phi 

0.166mm 

2.52 

phi 

0.179mra 

0.56 

phi 

-0.27 

1.29 

Composite 
Panama,  FL 
Analyzer 


Title 

Example  for  ACES  User's  Guide 
Comment 


Date  Analyzed 
07/02/92 
Total  Weight 


CEWES-CERC 
Type  of  Samples 


This  is  a  composite  of  Data  from  File  CGSEX.IN  100.00 

Samples  in  Composite  Top  of  Composite  Bottom  of  Composite 


Offshore 


ASTM 

MM 

PHI 

Weight 

MESH 

Site 

Size 

(%) 

30.00 

0.59 

0.757 

0.000 

35.00 

O.SO 

1.00 

4.122 

40.00 

0.42 

1.25 

1.063 

45.00 

0.35 

1.50 

1.783 

50.00 

0.30 

1.75 

3.724 

2 

0.00  feet 

ASTM 

MM 

PHI 

Weight 

MESH 

Size 

Size 

OB' 

60.00 

0.25 

2.00 

5.140 

70.00 

0.21 

2.25 

11.075 

80.00 

0.177 

2.50 

15.290 

100.0 

0.149 

2.75 

22.245 

120.0 

0.125 

3.00 

22.500 

0.00  feet 

ASTM 

MM 

PHI 

Weight 

MESH 

Size 

Size 

(%) 

140.0 

0.105 

3.25 

7.479 

170.0 

0.088 

3.50 

3.946 

200.0 

0.074 

3.75 

1.324 

230.0 

.0625 

4.00 

0.309 
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Plot  Output  File  2 

This  file  (default  name  PL0TDAT2.0UT)  contains  header  information  and 
percent  of  sand  weight  distribution  for  the  composite  generated  by  the  example 
problem. 

Table  6-3-2  is  a  listing  of  plot  output  file  2  for  this  example. 


Table  6-3-2 

Listing  of  Plot  Output  File  2  for  Example  Problem 

Panama,  FL  Example  for  ACES  User’s  Guide  1984 

CEWES-CERC  This  is  a  composite  of  data  from  file  CGSEX.IN 

O.OOf  O.OOf  O.OOf  OO.Of  1606792.00  406465.00  07/02/92 


Offshore 

Vibracore 

100.00 

14 

PHI 

c 

0.75 

0.000 

1.00 

4.122 

1.25 

1.063 

1.50 

1.783 

1.75 

3.724 

2.00 

5.140 

2.25 

11.075 

2.50 

15.290 

2.75 

22.245 

3.00 

22.500 

3.25 

7.479 

3.50 

3.946 

3.75 

1.324 

4.00 

0.309 

A  "C"  in  line  4  of  this  file  indicates  to  the  application  that  this  is  composite  data 
rather  than  sample  data.  Otherwise,  the  format  is  the  same  as  that  of  sand 
samples  read  from  an  external  file  or  written  to  the  trace  output  file.  Composite 
data  may  be  stored  in  a  file  containing  other  composite  or  sample  data  to  be 
plotted.  See  section  titled  Plot  Samples/Composites  on  the  Same  Screen  for 
more  information. 
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Screen  Plots 

This  application  generates  three  plots.  The  plots  may  be  accessed  from  the 
Composite  Grain-Size  Distribution  Plot  Selection  Menu,  which  is  displayed  when 
the  Plot  Output  Data  (£1)  option  is  requested.  The  plots  generated  by  the 
example  problem  are  shown  below  (Figures  6-3-7  to  6-3-9). 
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-  Folk  Measures  - 

Median  2.59  PHI 

Mean  Z.52  PHI 

Std.  Dew.  9.56  PHI 

Skeuness  —0.27 

Kurtosis  1.29 

—  Moment  Measures  — 

Mean  2.49  PHI 

Std.  Dew.  0.5H  PHI 

Skeuness  -0.90 

Kurtosis  3.98 

/ 

i - 1 - 1 - 4— ^ - 1 - - - 1- 

1.  1-5  Z.Q  2.5  3.0  3.5 

- I - 1 - 1 - 1 - 1 - T - 

0.3536  0.1766  8.039E-Z 

I - j - 1 - 1 

40  60  100  200 

Grain  Size  (PHI) 

Figure  6-3-7.  Frequency  Weight  Percent  for  Example  Problem 
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— 
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100-r 
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-  Folk  Measures  — 

Median  2.59  PHI 


Mean 

Std.  Dew. 

Skeuness 

Kurtosis 


2.52  PHI 
0.56  PHI 
-0.27 
1.29 


-  Moment  Measures  - 

Mean  2.49  PHI 

Std.  Dew.  0.58  PHI 

Skeuness  -0.90 

Kurtosis  3.9B 


0.5 


8.7071 


4.0 


0.3536 


9.1768 


B.839E-Z 


40 


68  1B8 

Grain  Size  (PHI) 


208 


(phi) 
(mm) 
ASTH  Mesh 


Figure  6-3-8.  Cumulative  Weight  Percent  for  Example  Problem 
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Compos Ite :  Panama .  FL 
— —  Folk  Measures - 


0.5000  0 .2500  0.1250  6.Z50E-Z  Cum) 

I - 1 - 1 - 1 

40  68  100  280  ftSTM  Mesh 

Grain  Size  (PHI) 

Figure  6-3-9.  Probability  Weight  Percent  for  Example  Problem 
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Beach  Nourishment  Overfill  Ratio  and  Volume 


Description 


The  methodologies  represented  in  this  ACES  application  provide  two  approaches 
to  the  planning  and  design  of  nourishment  projects.  The  first  approach  is  the 
calculation  of  the  overfill  ratio ,  which  is  defined  as  the  volume  of  actual  borrow 
material  required  to  produce  a  unit  volume  of  usable  fill.  The  second  approach 
is  the  calculation  of  a  renourishment  factor  which  is  germane  to  the  long-term 
maintenance  of  a  project  and  addresses  the  basic  question  of  how  often 
renourishment  will  be  required  if  a  particular  borrow  source  is  selected  that  is 
texturally  different  from  the  native  beach  sand. 


Input 


All  data  input  for  this  application  is  done  on  one  screen.  The  following  list 
describes  the  necessary  input  parameters  with  their  corresponding  units  and  range 
of  data  recognized  by  this  application: 


Mandatory  item 

Svmbol 

Units 

Data  Ranee 

Initial  Volume 

VOL! 

yd3,  m3 

1 

to  1  X 

108 

Native  Mean 

Mn 

phi,  mm 

-5.0 

to 

5.0 

Native  Standard  Deviation 

^  n 

phi 

0.01 

to 

5.0 

Borrow  Mean 

M„ 

phi,  mm 

-5.0 

to 

5.0 

Borrow  Standard  Deviation 

phi 

0.01 

to 

5.0 

NOTE:  Table  A-4  in  Appendix  A  provides  a  comparison  of 
grain-size  scales  and  classification  systems. 


Output 


Results  from  this  application  are  displayed  on  one  screen.  Those  data  include 
the  original  input  values  (in  final  units)  and  the  following  parameters: 
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Item 

Svmbol 

Enelish 

Metric 

Units 

Units 

Overfill  Ratio 

Ra 

Renourishment  Factor 

Rj 

Design  Volume 

vold 

yds 

m3 

Procedure 


This  application  provides  only  a  Single  Case  Mode.  The  Multiple  Case  Mode  is 
not  available.  The  bulleted  items  in  the  following  lists  indicate  potentially 
optional  instruction  steps.  Any  application  in  ACES  may  be  executed  in  a  given 
session  without  quitting  the  program.  The  bulleted  items  provide  instructions 
for  accessing  the  application  from  various  menu  areas  of  the  ACES  program. 
Ignore  bulleted  instruction  steps  that  are  not  applicable. 


Single  Case  Mode 

0  Press  (fT|  on  the  Main  Menu  to  select  Single  Case  Mode. 

0  Fill  in  the  highlighted  input  fields  on  the  General  Specifications  screen 
(or  leave  the  default  values).  Press  (fT)  when  all  data  on  this  screen 
are  correct. 

°  Press  (f^)  on  the  Functional  Area  Menu  to  select  Littoral  Processes. 

”  Press  fF4)  on  the  Littoral  Processes  Application  Menu  to  select  Beach 
Nourishment  Overfill  Ratio  and  Volume. 

1.  Fill  in  the  highlighted  input  fields  on  the  Beach  Nourishment  Overfill  Ratio 
and  Volume  screen.  Respond  to  any  corrective  instructions  appearing  at  the 
bottom  of  the  screen.  Press  (fT)  when  all  data  on  this  screen  are  correct. 

2.  All  input  and  output  data  are  displayed  on  the  screen  in  the  final  system  of 
units. 

3.  Press  Qne  of  the  following  keys  to  select  the  appropriate  action: 

(Fl)  Return  to  Step  1  for  a  new  case. 

[F3]  Send  a  summary  of  this  case  to  the  print  file  or  device. 

(no  I  Exit  this  application  and  return  to  the  Littoral  Processes 
Menu. 
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Input 


All  data  input  for  this  application  is  done  on  one  screen.  The  values  and 
corresponding  units  selected  for  this  example  problem  are  shown  below. 


Item 

Svmbol 

Value 

Units 

Initial  Volume 

VOL! 

800,000.0 

yd3 

Native  Mean 

M, 

1.800 

phi 

Native  Standard  Deviation 

an 

0.450 

phi 

Borrow  Mean  . 

2.250 

phi 

Borrow  Standard  Deviation 

Of 

0.760 

phi 

Output 


Results  from  this  application  are  displayed  on  one  screen.  Those  data  include 
the  original  input  values  and  the  following  parameters: 


Item 

Overfill  Ratio 
Renourishment  Factor 
Design  Volume 


Symbol  Value  Units 

Ra  2.003 

Rj  1.077 

VOLd  1,602,521.0  yd3 
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Description 

This  application  is  a  numerical  model  that  estimates  coastal  inlet  velocities, 
discharges,  and  bay  levels  as  functions  of  time  for  a  given  time-dependent  sea 
level  fluctuation.  Inlet  hydraulics  are  predicted  in  this  model  by  simultaneously 
solving  the  time-dependent  momentum  equation  for  flow  in  the  inlet  and  the 
continuity  equation  relating  the  bay  and  sea  levels  to  inlet  discharge.  The  model 
is  designed  for  cases  where  the  bay  water  level  fluctuates  uniformly  throughout 
the  bay  and  the  volume  of  water  stored  in  the  inlet  between  high  and  low  water 
is  negligible  compared  with  the  tidal  prism  of  water  that  moves  through  the  inlet 
and  is  stored  in  the  bay.  The  model  has  been  previously  described  by  Seelig 
(1977)  and  Seelig,  Harris,  and  Herchenroder  (1977).  Because  of  the  complexity 
of  this  methodology  and  the  input  requirements,  familiarization  with  the  above 
references  is  strongly  recommended. 

An  inlet-bay  system  typically  consists  of  a  sea  (ocean  or  lake)  connected  to  a 
bay  by  one  or  more  inlets.  Possible  system  configurations  that  this  ACES 
application  will  run  include- 

°  1-Sea  -  1 -Inlet  -  1-Bay  System 
°  1-Sea  -  2-Inlet  -  1-Bay  System 

°  2-Sea  Boundary  Condition  -  2-Inlet  -  1-Bay  System  (see  Figure  7-1-1) 


Figure  7-1-1.  Conceptual  2-Sea,  2-Inlet,  and  1-Bay  System 

CAUTION:  Only  the  1-Sea,  1-Inlet,  1-Bay  System  has  been  tested  with  this  version  of  the  model. 
Use  the  other  system  configurations  with  coutionl 


LIMITATION:  The  bay  and  inlet  must  contain  water  throughout  the  water  level  cycle.  This 
application  cannot  treat  shallow  inlet  areas  that  may  be  exposed  (dry  up)  during  any  portion  of  the 
tidal  cycle. 
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Input 

The  input  requirements  of  this  application  consist  of  five  general  types  of 
information: 

°  General  data  describing  system  configuration  and  temporal  data. 

0  Inlet  geometries  characterized  with  cross-section  tables  and  locations. 

°  Seaward  boundary  conditions  (tabulated  records  or  predicted  tides  using 
harmonic  constituents). 

“  Bayside  boundary  conditions  (bay  area  and  shape  factor,  and  other 
freshwater  inflows  distinct  from  inlet  contributions). 

°  Locations  where  velocity  hydrographs  are  to  be  reported  from  the 
simulation. 

Data  input  to  this  application  is  accomplished  through  numerous  input  screens 
or  through  data  saved  in  an  external  file.  Detailed  lists  of  the  screens  and  input 
parameters  are  presented  in  the  Procedure  section  of  this  document.  Also,  a 
review  of  the  referenced  documents  is  strongly  recommended. 


Output 

Results  from  this  application  are  written  to  the  plot  output  files  (1-3).  The 
contents  and  organization  of  output  data  in  the  plot  output  files  are  summarized 
below.  In  addition,  this  application  generates  numerous  screen  plots  (see  section 
titled  Plot  Output  Data). 


Plot  Output  File  1 

This  file  contains  tabular  summaries  of  grid  characteristics  for  equal  channel 
discharge  (based  upon  an  assumed  representative  velocity  for  the  minimal  cross 
section).  The  contents  of  the  file  are  for  general  information  only  and  are  relative 
to  assumptions  made  in  constructing  the  flow  net.  The  data  are  not  results  of 
the  simulation  using  the  time-dependent  sea  and  bay  hydrographs. 

Summarized  by  channel  for  each  cross  section  (for  each  inlet)  are  common 
geometric  properties  such  as  area,  width,  depth,  and  a  weighting  factor  describing 
the  flow  distribution  among  the  channels. 

Also  provided  for  each  cross  section  is  a  table  of  discharge  distribution  and  water 
depths  for  the  entire  cross  section,  tabulated  at  100  equally  spaced  segments 
across  the  section.  Finally,  a  table  of  friction  loss  (per  foot  of  channel)  is 
tabulated  by  cross  section. 
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Plot  Output  File  2 

This  file  contains  a  table  of  velocity  hydrographs  produced  by  the  simulation  at 
selected  flow  net  cell  locations.  The  velocities  (feet  per  second)  are  reported  at 
the  Tabular  Output  Time  Interval  and  represent  the  velocity  condition  at  the 
centers  of  the  selected  flow  net  cells. 


Plot  Output  File  3 

This  file  contains  elevation  and  discharge  hydrographs  for  the  sea  boundary 
conditions  (BC),  bay,  and  inlet(s).  Results  are  tabulated  at  the  Tabular  Output 
Time  Interval  and  represent  summary  conditions  at  the  indicated  times  for  the 
entire  system.  Included  are  sea  and  bay  elevations,  riverine  inflows,  average 
velocity  at  the  controlling  cross  section,  and  inlet  discharge. 

A  final  table  is  provided  that  summarizes  flood  and  ebb  regimes  and  volumes 
identified  during  the  simulation. 


Procedure 


This  application  provides  only  a  Single  Case  Mode.  The  Multiple  Case  Mode  is 
not  available.  The  Single  Case  Mode  requires  interaction  with  the  application 
and  provides  two  options  of  interactive  participation.  The  first  option  allows 
entering  new  data  sets,  and  the  second  option  allows  the  editing  of  existing  data 
files. 


Single  Case  Mode 

8  Press  (Fi)  on  the  Main  Menu  to  select  Single  Case  Mode. 

°  Fill  in  the  highlighted  input  fields  on  the  General  Specifications  screen 
(or  leave  the  default  values).  Press  (fT)  when  all  data  on  this  screen 
are  correct. 

0  Press  (ft)  on  the  Functional  Area  Menu  to  select  Inlet  Processes. 

8  Press  (fT)  on  the  Inlet  Processes  Menu  to  select  A  Spatially  Integrated 

Numerical  Model  for  Inlet  Hydraulics. 
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Data  Entry  Options  Menu 

This  menu  provides  two  options  of  interactive  participation  with  the  application. 
(fT|  Initial  Case  Data  Entry 

Use  this  option  to  enter  an  initial  (new)  set  of  data.  These  data  will 
be  written  to  the  Trace  Output  file  (default  name  TRACE.OUT)  and 
become  available  for  subsequent  editing  and  use. 


[Alt]  (fi)  Edit  Case  in  External  File:  INLET.IN 

Use  this  option  to  access  and  modify  data  saved  in  an  external  file. 
This  external  data  file  is  created  by  saving  (or  copying)  a  trace  file 
from  a  previous  execution  of  this  application.  The  format  and  contents 
of  the  trace  file  for  this  application  match  exactly  the  requirements  of 
this  input  file.  The  default  input  file  name  is  INLET.IN,  but  other 
file  names  (including  path  name)  are  acceptable.  After  entering  the 
file  name,  press  [enter  )  to  accept  this  file.  For  more  information  on 
files,  see  the  section  of  this  manual  entitled,  "General  Instructions  and 
Information.” 


Activity  Menu 

The  Activity  Menu  is  a  point  from  which  all  options  for  Single  Case  data  entry, 
modification,  and  execution  are  accessible.  The  options  are: 

(fi)  Begin  Computations. 

(f2)  General  Time  and  Inlet  Data  Entry. 

(F3)  Inlet(s)  Cross-Section  Data  Entry. 

[F4|  Sea(s)  Boundary  Condition  Data  Entry. 

(F5)  Bay  Boundary  Condition  Data  Entry. 

(F6)  Specify  Velocity  Output  Locations. 

(f 7}  Plot  Output  Data. 

(fio)  Exit  Menu. 

Each  option  and  the  required  data  are  described  below. 


(fi)  Begin  Computations 

Use  this  option  only  after  all  data  have  been  entered. 
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(F2)  General  Time  and  Inlet  Data  Entry 

This  screen  provides  for  input  of  general  parameters  required  to  run  the 
application.  Values  for  all  parameters  listed  are  required. 


Item 

Units 

Data  Ranee 

Profile  point  units 

ft,m 

Simulation  start  time: 

Year 

1900 

to 

2050 

Month 

1 

to 

12 

Day 

1 

to 

31 

Hour 

0 

to 

24 

Time  step 

sec 

60 

to 

300 

Length  of  simulation 

hr 

0 

to 

48 

Tabular  output  time  interval 

min 

2 

to 

360 

NOTE:  The  tabular  output  time  interval  must  be  a  multiple  of 
the  time  step,  and,  at  a  minimum,  it  must  be  at  least  twice  the 
time  step. 


Number  of  inlets 

1 

or  2 

Number  of  bays 

1 

Number  of  seaward  boundary  condition  locations 

1 

or  2 

The  following  data  are  required  for  each  inlet: 

Number  of  channels 

1 

to 

7 

Number  of  cross  sections 

1 

to 

16 

Flood  loss  coefficient 

0.0 

to 

10.0 

Ebb  loss  coefficient 

0.1 

to 

10.0 

Coefficient  Cx  to  evaluate  Manning’s  n 

0.001 

to 

3.0 

Coefficient  C2  to  evaluate  Manning’s  n 

0.00001 

to 

1.0 

NOTE:  After  completing  data  entry  on  this  screen,  press  (Flo) 
to  return  to  the  Activity  Menu. 
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(F3]  Inlct(s)  Cross-Section  Data  Entry 

This  series  of  screens  provides  for  input  of  data  that  will  be  used  to  construct 
a  flow  net  (or  grid)  for  the  inlet(s).  The  flow  net  is  used  to  characterize  hydraulic 
properties  and  bottom  friction  throughout  the  inlet  (see  Seelig,  Harris,  and 
Herchenroder,  1977,  Appendix  B).  This  application  will  accept  1  or  2  inlets 
with  a  maximum  of  16  cross  sections  per  inlet.  Each  cross  section  can  be  defined 
by  a  maximum  of  54  elevations  spaced  at  a  constant  distance  (AX).  Cross  sections 
should  be  indexed  in  ascending  order  from  sea  to  bay  through  the  inlet.  Channels 
are  indexed  in  ascending  order  from  left  to  right  (from  a  seaward  perspective). 
In  Figure  7-1-2  a  flow  net  with  six  channels  and  eight  cross  sections  is  depicted. 
Figure  7-1-3  shows  a  simple  cross  section  consisting  of  nine  equally  spaced 
elevation  points. 
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Item/Description 


Units  Data  Ranee 


Inlet*  -  (index)  1  or  2 

Cross  sectionj  _  (index)  1  to  16 


Press  (fT)  to  access  the  screen  for  input  of  specific  cross-section  data. 


AX  -  horizontal  spacing  of  cross-section  ft,m  1.0  to  5,000.0 
points 

NOTE:  This  distance  should  be  small  enough  so  that  linear 
interpolation  between  elevation  readings  will  adequately  describe 
the  bottom  topography  for  each  cross  section. 


AY  -  distance  to  the  next  cross  section  ft,m  5.0  to  10,000.0 


NOTE:  For  the  last  cross  section,  the  AY  must  be  0.0. 


ELk  -  cross-section  elevations  relative  to  -999.999  to  0.0 

still- water  level  ( k  =  1 . . . K ,  /£  £  54) 


CAUTION:  The  first  and  last  elevation  on  each  cross  section 
must  be  0.0.  Because  the  inlet  must  contain  water  throughout 
the  water  level  cycle,  cross-section  elevations  throughout  the 
inlet  should  exceed  the  lowest  point  in  the  water  cycle. 


NOTE:  If  there  are  more  than  27  elevation  points  for  the  selected 
cross  section,  press  (fT)  to  access  another  screen  for  entering 
remaining  (27  through  54)  elevation  values.  After  completing 
elevation  data  entry  for  one  cross  section,  press  [fio)  to  return  to 
the  Activity  Menu.  Then  press  (fD  to  continue  entering  elevation 
data  for  the  next  cross  section. 


A  Spatially  Integrated  Numerical  Model  for  Inlet  Hydraulics 


7-1-7 


ACES  User’s  Guide 


Inlet  Processes 


[F4]  Sea(s)  Boundary  Condition  (BC)  Data  Entry 


This  series  of  screens  provides  for  the  input  of  the  seaward-side  forcing  boundary 
conditions  for  the  model.  Water  levels  may  be  described  by  tabulated  entries 
(120  maximum)  collected  at  a  constant  sampling  interval.  Alternately,  tides  can 
be  expressed  as  a  constituent  tide  record  with  an  amplitude  and  epoch  for  any 
of  37  constituents  (see  Table  A-5,  Appendix  A). 


Item /Description 
Sea  BCj  -  (index) 

Sea  BC  type  -  (constituent  or  tabulated) 

Sea  BC  At  -  time  interval  for  tabulated 
or  generated  BC  hydrograph  record 

Press  (fT)  to  continue  input. 


Units  Data  Ranee 
1  or  2 
Tab  or  Con 
min  0.0  to  720.0 


Tabulated  Data 


Item/Pescription  Units 

Sea  BC  elevation  units  ft,  m 

Press  (fT)  to  continue  tabulated  data  input. 
Sea  BC  ELm  (m=  1..M,  M<  120)  ft,m 


Data  Range 


-999.99  to  9,999.99 


NOTE:  Each  screen  will  accept  a  maximum  of  30  values.  Press 
(fT)  to  continue  tabulated  input  (maximum  120  values).  When 
finished  entering  all  elevation  data,  press  [fio]  to  return  to  the 
Activity  Menu. 


CAUTION:  The  simulation  begins  with  a  sea  level  of  zero  and 
zero  current,  which  means  the  sea  boundary  condition  should 
reflect  these  conditions.  This  can  be  achieved  by  ensuring  that 
tabulated  entries  begin  with  a  gradual  change  (slope  of  the 
forcing  boundary  condition  time  series  is  near  zero  at  the 
beginning  of  the  simulation). 
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NOTE:  The  total  time  span  for  tabulated  water  levels  must 
equal  or  exceed  the  Length  of  Simulation.  For  example,  if  the 
time  interval  between  tabulated  water  level  entries  is  30  minutes 
and  there  are  77  entries,  then  the  Length  of  Simulation  must 
be  less  than  or  equal  to  38  hours. 


(77-  1)*30  minutes 
60minutQS 


= 38 hours 


Constituent  Tide  Data 

Item/Description  Units  Data  Range 

Sea  BC  longitude  deg  WEST  -180.0  to  180.0 

Sea  BC  amplitude  units  ft,m 

Press  (fi)  to  continue  constituent  tide  data  input. 


Amplituden  of  individual 
constituent 

ft,m 

0.0 

to  999.99 

Epochn  of  individual  constituent 

deg 

0.0 

to  360.0 

NOTE:  The  names  of  37  common  harmonic  constituents  (see 
Table  A-5,  Appendix  A)  are  displayed  on  a  series  of  screens. 
Place  the  values  of  amplitude  and  epoch  by  the  appropriate  desired 
constituent  name.  Press  (fT)  to  continue  additional  constituent 
input  on  subsequent  screens.  When  finished  entering  all  data, 
press  [fio]  to  return  to  the  Activity  Menu. 
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[fs]  Bay  Boundary  Condition  Data  Entry 

This  series  of  screens  provides  for  the  input  of  bay  characteristics  and  inflows 
from  a  source  (river)  other  than  the  inlet.  Bay  surface  area  is  the  only  required 
input. 


I  tem  /Description 
Area  -  bay  surface  area 
Bay  a  -  bay  area  variation  parameter 
Press  (fT)  to  continue  input. 

Inflow  At-  time  interval  for  river 
discharge  inflow  hydrograph 
Inflow  Q  units  -  river  discharge  units 


Units 
ft2,  m2 


mm 


cfs,cms 


Data  Range 
9xl04  to  IxlO10 
0.0  to  3.3 

0.0  to  720.0 


Press  (fT)  to  access  the  screen  for  entering  tabulated  river  discharge  data. 

Inflow  Qjj  (ii=  I . ..//.  //,<120)-  cfs,cms  0.0  to  9,999.99 

tabulated  values  of  river  inflow 
discharges 


NOTE:  If  there  are  more  than  30  discharge  values  to  be  entered, 
press  (fT)  to  access  subsequent  screens  for  entering  the  remaining 
values  (each  screen  will  allow  input  of  30  values).  After  completing 
discharge  data  entry,  press  [Flo]  to  return  to  the  Activity  Menu. 


CAUTION:  Because  the  simulation  begins  with  zero  current 
in  the  inlet,  it  is  advisable  to  begin  any  river  discharge  with 
zero  inflow  and  gradually  build  up  to  the  desired  hydrograph 
for  the  simulation. 


NOTE:  The  total  time  span  for  tabulated  river  discharge  inflow 
must  equal  or  exceed  the  Length  of  Simulation.  For  example, 
if  the  time  interval  between  river  discharge  inflow  entries  is 
240  minutes  and  there  are  nine  entries,  then  the  Length  of 
Simulation  must  be  less  than  or  equal  to  32  hours. 


(9-  1)*240  minutes 
60minutes 


= 32 hours 
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[F6]  Specify  Velocity  Output  Locations 

This  series  of  screens  provides  for  input  of  specific  cell  locations  in  the  flow 
net  grid  where  inlet  velocities  are  desired  (see  Figure  7-1-4).  Inlet  velocities 
are  computed  at  the  specified  Time  Step  at  all  grid  cells,  but  only  values  at  the 
Tabular  Output  Time  Interval  and  at  the  specified  cell  locations  are  saved  for 
output.  The  computed  velocities  are  at  the  center  of  the  flow  net  cells  (see 
figure  below).  These  velocity  values  are  written  to  plot  output  file  2.  A  maximum 
of  20  locations  can  be  identified,  and  a  minimum  of  I  location  is  required. 


Item /Description 
Inlets  -  (index) 

Cross  Section^  -  (index) 
Channel^  -  (index) 


Units  Data  Range 

1  or  2 
1  to  15 
1  to  6 


NOTE:  If  there  are  more  than  10  grid  cells  to  be  specified,  press 
[fT)  to  access  another  screen  for  inputting  the  remaining  (1 1-20) 
cell  locations.  After  completing  grid  cell  Location  data  entry,  press 
(fio]  to  return  to  the  Activity  Menu. 
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For  example,  in  Figure  7-1-4,  four  cell  locations  for  a  1-sea,  2-inlet,  1-bay 
system  are  shown.  A  cell  is  referenced  by  Inlet,  Cross  Section,  and  Channel 
numbers. 


Inlet  - 
Inlet  - 
Inlet  - 
Inlet  - 


1;  Cross  Section  - 
1;  Cross  Section  - 
1;  Cross  Section  - 
2;  Cross  Section  - 


1;  Channel  - 
3;  Channel  - 
5;  Channel  - 
1;  Channel  - 


1 

2 

4 

1 


[F7)  Plot  Output  Data 

This  application  generates  numerous  plots.  The  plots  may  be  accessed  from  the 
INLET  PLOT  SELECTION  MENU,  which  appears  when  the  Plot  Output  Data 
option  is  requested.  To  access  a  plot,  move  the  cursor  (using  the  arrow  keys) 
to  the  desired  plot  and  press  (fT).  (Appendix  C  describes  options  to  customize 
plots.)  Available  plots  are: 

°  Predicted  Water  Velocities  at  Specified  Cells  (see  Figure  7-1-5  of 
Example  Problem  1) 

NOTE:  This  option  displays  a  menu  for  selecting  specific 
cells  for  which  predicted  water  velocities  are  to  be 
plotted.  Use  the  arrow  keys  to  move  the  cursor  to  the 
desired  cells  and  enter  an  x.  When  finished  selecting 
the  cells,  press  @  to  begin  plotting.  If  more  than  one 
cell  was  selected,  use  the  NEXT  option  of  the  graphics 
package  (Appendix  C)  to  view  each  plot  successively. 

'■  Sea  &  Bay  Elevations  at  Each  Inlet  (see  Figure  7-1-6  of  Example 
Problem  1) 

°  Riverine  Inflow  (see  Figure  7-1-7  of  Example  Problem  1) 

Predicted  Velocity  at  the  Controlling  Cross  Section  (Figure  7-1-8 
of  Example  Problem  1) 

Discharge  at  Each  Inlet  (see  Figure  7-1-9  of  Example  Problem  1) 
0  ALL  PLOTS 

NOTE:  This  option  will  make  all  the  plots  available  for 
viewing.  Use  the  NEXT  option  of  the  graphics  package 
(Appendix  C)  to  view  each  plot  successively. 

°  EXIT  MENU 
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Example  Problems 


Example  1  -  One- Inlet,  One- Bay,  and  One-Sea  System  with  Constituent 
Tide  and  River  Discharge  Data 

Example  1  Input 

All  input  is  accomplished  through  screens  accessible  from  the  Activity  Menu. 
(F2)  General  Time  and  Inlet  Data  Entry 


Simulation  start  time: 

Year  1988 

Month  7 

Day  6 

Hour  0.00 

Time  step  60  sec 

Length  of  simulation  30  hr 

Tabular  output  time  interval  15  min 

Number  of  inlets  1 

Number  of  bays  1 

Number  of  seaward  boundary  condition 

locations  1 

Inlet  1 

Number  of  channels  4 

Number  of  cross  sections  5 

Flood  loss  coefficient  4.00 

Ebb  loss  coefficient  1.00 

Coefficient  Cx  to  evaluate  Manning’s  n  0.05 

Coefficient  C2  to  evaluate  Manning’s  n  0.0007 
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(Example  1  Input  Continued) 

(F3]  Inlet(s)  Cross-Section  Data  Entry 


Data  for  five  cross  sections  will  be  used  in  this  first  example. 

Inlet  1  Cross  Section  ! 

AX  =  104.00  ft 
A  Y  =  1750.00  ft 

Elevations  (ft) 


1 

0.0 

16 

-13.0 

31 

-32.0 

2 

-27.0 

17 

-13.0 

32 

-24.0 

3 

-27.0 

18 

-13.0 

33 

-24.0 

4 

-27.0 

19 

-13.0 

34 

-24.0 

5 

-27.0 

20 

-18.0 

35 

-24.0 

6 

-27.0 

21 

-24.0 

36 

-25.0 

7 

-27.0 

22 

-30.0 

37 

-25.0 

8 

-27.0 

23 

-32.0 

38 

-18.0 

9 

-27.0 

24 

-34.0 

39 

-18.0 

10 

-27.0 

25 

-34.0 

40 

-18.0 

11 

-27.0 

26 

-34.0 

41 

-18.0 

12 

-18.0 

27 

-34.0 

42 

0.0 

13 

-13.0 

28 

-32.0 

14 

-13.0 

29 

-32.0 

15 

-13.0 

30 

-32.0 

Inlet  !  Cross  Section  2 
AX  =  104.00  ft 
AY  =  1625.00  ft 


Elevations  (ft) 


1 

0.0 

6 

-34.0 

11 

-30.0 

2 

-30.0 

7 

-34.0 

12 

-30.0 

3 

-33.0 

8 

-34.0 

13 

-20.0 

4 

-33.0 

9 

-34.0 

14 

-10.0 

5 

-33.0 

10 

-34.0 

15 

0.0 
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(Example  1  Input  Continued) 
Inlet  1  Cross  Section  3 
AX  =  104.00  ft 
A  Y  =  1917.00  ft 

Elevations  (ft) 


1 

0.0 

9 

-34.0 

17 

-8.0 

2 

-12.0 

10 

-34.0 

18 

-8.0 

3 

-18.0 

11 

-34.0 

19 

-8.0 

4 

-20.0 

12 

-34.0 

20 

-6.0 

5 

-25.0 

13 

-34.0 

21 

-6.0 

6 

-30.0 

14 

-30.0 

22 

-6.0 

7 

-33.0 

15 

-18.0 

23 

-6.0 

8 

-34.0 

16 

-12.0 

24 

0.0 

Inlet  1  Cross  Section  4 
AX  =  104.00  ft 
AY  =  1250.00  ft 

Elevations  (ft) 


1 

0.0 

6 

-50.0 

11 

-34.0 

2 

-18.0 

7 

-50.0 

12 

-24.0 

3 

-37.0 

8 

-34.0 

13 

-18.0 

4 

-37.0 

9 

-34.0 

14 

0.0 

5 

-50.0 

10 

-34.0 

Inlet  1  Cross  Section  5 
AX  =  104.00  ft 
A  Y  =  0.00  ft 

Elevations  (ft)  . 


1 

0.0 

13 

-18.0 

25 

-10.0 

2 

-11.0 

14 

-25.0 

26 

-10.0 

3 

-11.0 

15 

-25.0 

27 

-10.0 

4 

-11.0 

16 

-20.0 

28 

-10.0 

5 

-12.0 

17 

-20.0 

29 

-10.0 

6 

-12.0 

18 

-20.0 

30 

-10.0 

7  . 

-17.0 

19 

-34.0 

31 

-10.0 

8 

-17.0 

20 

-34.0 

32 

-10.0 

9 

-17.0 

21 

-34.0 

33 

-10.0 

10 

-15.0 

22 

-34.0 

34 

-10.0 

11 

-15.0 

23 

-23.0 

35 

-10.0 

12 

-15.0 

24 

-18.0 

36 

-10.0 

37 

0.0 
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(Example  I  Input  Continued) 

[F4]  Sea(s)  Boundary  Condition  Data  Entry 

Sea  BC 

1 

Sea  BC  type 

Con 

Sea  BC  At 

15.00  min 

Sea  BC  longitude 

75.00  deg  WEST 

Sea  BC  amplitude  units 

ft 

Length  of  simulation 

30  hr 

Tabular  output  time  interval 

15  min 

Constituent  tide  data 

Harmonic  Amplitude  (ft)  Epoch  (deg) 

Constituent 

M2 

2.0  90.0 

NOTE:  All  other  harmonic  constituents  are  zero  for  this  example 

problem. 

(F5]  Bay  Boundary  Condition  Data  Entry 

Bay 

Bay  surface  area 

Bay  area  variation  parameter  a 

Inflow  At 

Inflow  Q  units 

1 

1 .80E+9  ft2 
0.00 

260.00  min 
cfs 

River  Discharge  (cfs) 

1  4000.0  4 

3200.0 

7 

4200.0 

2  3800.0  5 

3500.0 

8 

4300.0 

3  3600.0  6 

3800.0 

9 

4500.0 

(F6)  Specify  Velocity  Output  Locations 

Inlet 

Cross  Section 

Channel 

1 

2 

2 

1 

2 

1 

1 

2 

3 

1 

2 

4 
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Example  1  Output 

Results  from  this  application  are  written  to  three  plot  output  files.  In  addition, 
this  application  generates  numerous  screen  plots. 

Plot  Output  File  1 

This  file  contains  tabular  summaries  of  various  grid  characteristics  for  equal 
channel  discharge.  Summarized  by  channel  for  each  cross  section  (for  each  inlet) 
are  common  geometric  properties  such  as  area,  width,  depth,  and  a  weighting 
factor  describing  the  flow  distribution  among  all  the  channels.  Also  provided 
for  each  cross  section  is  a  table  of  discharge  distribution  and  water  depths  for 
the  entire  cross  section,  tabulated  at  100  equally  spaced  segments  across  the 
section.  Finally,  a  table  of  friction  loss  (per  foot  of  channel)  is  tabulated  by 
cross  section.  Table  7-1-1  is  a  partial  list  of  the  data  in  the  output  file  1  (default 
name  PLOTDATl.OUT)  for  cross  sections  1  and  5  only. 


Table  7-1-1 

Partial  Listing  of  Plot  Output  File  1  for  Example  Problem  1 


Inlet  1  Cross  Section  1 

Total  area  (ft2) 

100360.00 

Total  width  (ft) 

4264.00 

Channel  ->, 

1 

2  3  4 

Area  (ft2) 

23245.7  36558.4  9483.8  31071.7 

Width  (ft) 

912.9 

1708.6  288.0  1354.5 

Depth  (ft) 

25.5 

21.4  32.9  22.9 

Weight 

0.2521 

0.2458  0.2513  0.2508 

X 

Discharge  (cfs) 

Depths  (ft) 

42.661 

0.015 

5.541 

85.323 

0.209 

16.622 

127.984 

0.894 

25.949 

170.645 

1.029 

27.014 

213.307 

1.029 

27.014 

255.968 

1.029 

27.014 

298.629 

1.029 

27.014 

341.291 

1.029 

27.014 

383.952 

1.029 

27.014 

4 

4 

4 

4095.491 

0.235 

18.009 

4138.152 

0.235 

18.009 

4180.813 

0.204 

17.128 

4223.474 

0.055 

10.712 

4266.135 

0.004 

3.334 

(Table  7 

-1-1  Continued  on  the  Next  Page) 
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(Example  1  Output  Continued) 


(Table  7-1-1  Concluded) 


Inlet  1  Cross  Section  5 

Total  area  (ft2) 

60112.00 

Total  width  (ft) 

3744.00 

Channel  -> 

1 

2  3 

4 

Area  (ft2) 

22912.5 

6873.2  5186.1 

25139.6 

Width  (ft) 

1507.7 

325.9  155.5 

1754.9 

Depth  (ft) 

15.3 

24.3  34.0 

14.7 

Weight 

0.2850 

0.3649  0.0600 

0.2901 

X 

Discharge  (cfs) 

Depths  (ft) 

37.459 

0.002 

1.982 

74.917 

0.024 

5.946 

112.376 

0.087 

9.810 

149.835 

0.117 

11.006 

187.294 

0.117 

11.006 

224.752 

0.117 

11.006 

262.211 

0.117 

11.006 

299.670 

0.117 

11.006 

337.129 

0.119 

11.087 

374.587 

0.130 

1 1 .427 

l 

i 

l 

3633.498 

0.090 

10.005 

3670.956 

0.064 

8.773 

3708.415 

0.017 

5.225 

3745.874 

0.020 

1.626 

Summary  of  Friction  Losses 
Section  Friction  Loss/ft  of  Channel 
Length  (dimensionless) 


1 

2 

3 

4 

5 


43.992 

2.460 

14.245 

3.332 

35.970 


7-1-18 


A  Spatially  Integrated  Numerical  Model  for  Inlet  Hydraulics 


Inlet  Processes 


ACES  User’s  Guide 


(Example  1  Output  Continued) 

Plot  Output  File  2 


This  file  (Table  7-1-2,  default  name  PL0TDAT2.0UT)  contains  a  table  of 
velocity  hydrographs  produced  by  the  simulation  at  selected  flow  net  cell  locations. 
The  velocities  (feet  per  second)  are  reported  at  the  Tabular  Output  Time  Interval 
and  represent  the  velocity  condition  at  the  centers  of  the  selected  flow  net  cells. 
Figure  7-1-5  is  a  velocity  hydrograph  at  cell  (1,2,2)  of  the  inlet. 


Table  7-1-2 

Listing  of  Plot  Output  File  2  for  Example  Problem  1 


Hour 

(1,2,2) 

(1,2,1) 

(1,2,3) 

(1,2,4) 

0.27 

-6.42 

-2.53 

-6.56 

-1.56 

0.50 

-9.02 

-3.55 

-9.21 

-2.18 

0.77 

-10.12 

-3.97 

-10.33 

-2.44 

1.00 

-10.63 

-4.16 

-10.85 

-2.55 

1.27 

-11.00 

-4.30 

-11.23 

-2.62 

1.50 

-11.19 

-4.36 

-11.43 

-2.66 

1.77 

- 1 1 .26 

-4.38 

-11.50 

-2.67 

2.00 

-11.19 

-4.35 

-11.43 

-2.64 

4 

l 

4 

4 

4 

28.00 

-10.50 

-4.08 

-10.73 

-2.48 

28.27 

-9.55 

-3.71 

-9.76 

-2.25 

28.50 

-8.55 

-3.32 

-8.73 

-2.02 

28.77 

-7.16 

-2.79 

-7.32 

-1.70 

29.00 

-5.67 

-2.21 

-5.79 

-1.35 

29.27 

-3.49 

-1.36 

-3.56 

-0.83 

29.50 

-0.81 

-0.32 

-0.83 

-0.19 

29.77 

3.45 

1.35 

3.52 

0.83 

30.00 

5.48 

2.16 

5.60 

1.33 

Figure  7-1-5.  Velocity  Hydrograph  at  Cell  (1,2,2) 
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(Example  1  Output  Continued) 
Plot  Output  File  3 


This  file  contains  elevation  and  discharge  hydrographs  for  the  sea  boundary 
conditions,  bay,  and  inlet(s).  Results  are  tabulated  at  the  Tabular  Output  Time 
Interval  and  represent  summary  conditions  at  the  indicated  times  for  the  entire 
system.  Included  in  the  file  are  sea  and  bay  elevations,  riverine  inflows,  average 
velocity  at  the  controlling  cross  section,  and  inlet  discharge.  Also  included  in 
the  file  is  a  summary  of  flood  and  ebb  regimes  and  volumes  identified  during 
the  simulation.  Table  7-1-3  is  a  partial  listing  of  data  contained  in  plot  output 
file  3  (default  name  PL0TDAT3.0UT).  Figures  7-1-6  through  7-1-9  are 
hydrograph  plots  of  these  parameters. 


Table  7-1-3 

Partial  Listing  of  Plot  Output  File  3  for  Example  Problem  1 


Time 

Sea  El 

Bay  El 

Riverine 

Controlling  Inlet  Q 

(hr) 

(ft) 

(ft) 

Inflow 

(cfs) 

Section  (cfs) 

Vel 
(cfs) 

0.27 

-0.80 

-0.03 

3993.10 

-2.90  -123469.20 

0.50 

-1.00 

-0.10 

3985.94 

-4.07  -172096.80 

0.77 

-1.21 

-0.20 

3976.59 

-4.56  -191325.90 

1.00 

-1.38 

-0.29 

3967.49 

-4.78  -199430.30 

1.27 

-1.55 

-0.39 

3956.17 

-4.94  -204821.00 

1.50 

-1.67 

-0.49 

3945.55 

-5.02  -207072.10 

1.63 

-1.73 

-0.54 

3939.24 

-5.04  -207424.60 

1.73 

-1.77 

-0.58 

3934.39 

-5.05  -207260.20 

1.77 

-1.79 

-0.60 

3932.75 

-5.05  -207125.00 

11 

11 

11 

H  H 

28.77 

-1.47 

-1.10 

4269.00 

-3.21  -131937.30 

29.00 

-1.31 

-1.15 

4271.69 

-2.55  -104957.00 

29.27 

-1.11 

-1.20 

4275.25 

-1.57  -64973.95 

29.50 

-0.92 

-1.21 

4278.98 

-0.36  -15196.69 

29.53 

-0.89 

-1.22 

4279.58 

0.15  -6093.05 

29.77 

-0.68 

-1.20 

4284.22 

0.55  65138.12 

30.00 

-0.46 

-1.16 

4289.85 

2.47  104461.80 

Inlet  #1 

Start  Time 

End  Time 

Volume 

(ft3xl000) 

Ebb 

0.03 

4.47 

-2551027.00 

Flood 

4.50 

11.30 

3883867.00 

Ebb 

1.33 

17.10 

-3765760.00 

Flood 

17.13 

23.67 

3693283.00 

Ebb 

23.70 

29.53 

-3843678.00 

Flood 

29.57 

30.00 

99142.08 
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(Example  1  Output  Continued) 


Seaward  Uater  Love I 
Bay  Water  Level 


Figure  7-1-6.  Sea  and  Bay  Water  Elevations  at  Inlet  1 


Figure  7-1-7.  Riverine  Inflow 
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Example  2  -  One-Inlet,  One-Bay,  and  One-Sea  System  with  Tabulated  Data 
Example  2  Input 

All  input  is  accomplished  through  screens  accessible  from  the  Activity  Menu. 


(F2)  General  Time  and  Inlet  Data  Entry 

Simulation  start  time: 

Year  1988 

Month  8 

Day  23 

Hour  12.00 

Time  step  60  sec 

Length  of  simulation  38  hr 

Tabular  output  time  interval  30  min 

Number  of  inlets  1 

Number  of  bays  1 

Number  of  seaward  boundary  condition  1 

locations 


Inlet  1 

Number  of  channels  4 

Number  of.  cross  sections  5 

Flood  loss  coefficient  4.00 

Ebb  loss  coefficient  1.00 

Coefficient  Cj  to  evaluate  Manning’s  n  0.05 

Coefficient  C2  to  evaluate  Manning’s  n  0.0007 
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(Example  2  Input  Continued) 


(F3)  Inlet(s)  Cross-Section  Data  Entry 

Data  for  five  cross  sections  will  be  used  in  this  second  example. 

Inlet  1  Cross  Section  1 
A  X  =  104.00  ft 
A  Y  =  1750.00  ft 


Elevations  (ft) 


I 

0.0 

16 

-13.0 

31 

-32.0 

2 

-27.0 

17 

-13.0 

32 

-24.0 

3 

-27.0 

18 

-13.0 

33 

-24.0 

4 

-27.0 

19 

-13.0 

34 

-24.0 

5 

-27.0 

20 

-18.0 

35 

-24.0 

6 

-27.0 

21 

-24.0 

36 

-25.0 

7 

-27.0 

22 

-30.0 

37 

-25.0 

8 

-27.0 

23 

-32.0 

38 

-18.0 

9 

-27.0 

24 

-34.0 

39 

-18.0 

10 

-27.0 

25 

-34.0 

40 

-18.0 

11 

-27.0 

26 

-34.0 

41 

-18.0 

12 

-18.0 

27 

-34.0 

42 

0.0 

13 

-13.0 

28 

-32.0 

14 

-13.0 

29 

-32.0 

15 

-13.0 

30 

-32.0 

Inlet  i  Cross  Section  2 
AX  =  104.00  ft 
A  Y  =  1625.00  ft 

Elevations  (ft) 


1 

0.0 

6 

-34.0 

11 

-30.0 

2 

-30.0 

7 

-34.0 

12 

-30.0 

3 

-33.0 

8 

-34.0 

13 

-20.0 

4 

-33.0 

9 

-34.0 

14 

-10.0 

5 

-33.0 

10 

-34.0 

15 

0.0 
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(Example  2  Input  Continued) 
Inlet  i  Cross  Section  3 
AX  =  104.00  ft 
AY  =  1917.00  ft 

Elevations  (ft! 


1 

0.0 

9 

-34.0 

17 

-8.0 

2 

-12.0 

10 

-34.0 

18 

-8.0 

3 

-18.0 

11 

-34.0 

19 

-8.0 

4 

-20.0 

12 

-34.0 

20 

-6.0 

5 

-25.0 

13 

-34.0 

21 

-6.0 

6 

-30.0 

14 

-30.0 

22 

-6.0 

7 

-33.0 

15 

-18.0 

23 

-6.0 

8 

-34.0 

16 

-12.0 

24 

0.0 

Inlet  1  Cross  Section  4 
AX  =  104.00  ft 
A  Y  =  1250.00  ft 

Elevations  (ft! 


1 

0.0 

6 

-50.0 

11 

-34.0 

2 

-18.0 

7 

-50.0 

12 

-24.0 

3 

-37.0 

8 

-34.0 

13 

-18.0 

4 

-37.0 

9 

-34.0 

14 

0.0 

5 

-50.0 

10 

-34.0 

Inlet  1  Cross  Section  5 
AX  =  104.00  ft 
A  Y  =  0.00  ft 

Elevations  (ft! 


I 

0.0 

13 

-18.0 

25 

-10.0 

2 

-11.0 

14 

-25.0 

26 

-10.0 

3 

-11.0 

15 

-25.0 

27 

-10.0 

4 

-11.0 

16 

-20.0 

28 

-10.0 

5 

-12.0 

17 

-20.0 

29 

-10.0 

6 

-12.0 

18 

-20.0 

30 

-10.0 

7 

-17.0 

19 

-34.0 

31 

-10.0 

8 

-17.0 

20 

-34.0 

32 

-10.0 

9 

-17.0 

21 

-34.0 

33 

-10.0 

10 

-15.0 

22 

-34.0 

34 

-10.0 

11 

-15.0 

23 

-23.0 

35 

-10.0 

12 

-15.0 

24 

-18.0 

36 

-10.0 

37 

0.0 
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(Example  2  Input  Continued) 

(F4)  Sea(s)  Boundary  Condition  Data  Entry 

Sea  BC  1 

Sea  BC  type  Tab 

Sea  BC  a  t  30.00  min 


Tabulated  Time-Series  Data  Elevations  (ft) 


1 

-0.500 

21 

1.550 

41 

0.640 

61 

0.340 

2 

-0.490 

22 

1.650 

42 

0.480 

62 

0.450 

3 

-0.470 

23 

1.740 

43 

0.320 

63 

0.560 

4 

-0.430 

24 

1.820 

44 

0.180 

64 

0.680 

5 

-0.370 

25 

1.890 

45 

0.060 

65 

0.800 

6 

-0.300 

26 

1.940 

46 

-0.050 

66 

0.920 

7 

-0.220 

27 

1.980 

47 

-0.150 

67 

1.030 

8 

-0.120 

28 

2.000 

48 

-0.220 

68 

1.140 

9 

-0.020 

29 

2.000 

49 

-0.270 

69 

1.250 

10 

0.100 

30 

1.980 

50 

-0.300 

70 

1.350 

11 

0.220 

31 

1.940 

51 

-0.300 

71 

1.440 

12 

0.350 

32 

1.880 

52 

-0.290 

72 

1.530 

13 

0.490 

33 

1.790 

53 

-0.260 

73 

1.600 

14 

0.630 

34 

1.690 

54 

-0.230 

74 

1.670 

15 

0.770 

35 

1.570 

55 

-0.180 

75 

1.720 

16 

0.910 

36 

1.430 

56 

-0.110 

76 

1.760 

17 

1.050 

37 

1.280 

57 

-0.040 

77 

1.780 

18 

1.190 

38 

1.130 

58 

0.040 

78 

1.800 

19 

1.310 

39 

0.970 

59 

0.130 

20 

1.440 

40 

0.800 

60 

0.230 

[F5]  Bay  Boundary  Condition  Data  Entry 

Bay 

Bay  Surface  Area 

Bay  Area  Variation  Parameter  a 
Inflow  A  t 

Inflow  Q  units 

1 

1.80E+9  ft2 

0.00 

0  min 

cfs 

[F6]  Specify  Velocity  Output  Locations 

Inlet  Cross  Section 

Channel 

I  2 

2 

1  2 

1 

1  2 

3 

I  2 

4 
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Example  2  Output 

Results  from  this  application  are  written  to  three  plot  output  files.  In  addition, 
this  application  generates  numerous  screen  plots. 

Plot  Output  File  1 

This  file  contains  tabular  summaries  of  various  grid  characteristics  for  equal 
channel  discharge.  Summarized  by  channel  for  each  cross  section  (for  each  inlet) 
are  common  geometric  properties  such  as  area,  width,  depth,  and  a  weighting 
factor  describing  the  flow  distribution  among  all  the  channels.  Also  provided 
for  each  cross  section  is  a  table  of  discharge  distribution  and  water  depths  for 
the  entire  cross  section,  tabulated  at  100  equally  spaced  segments  across  the 
section.  Finally,  a  table  of  friction  loss  (per  foot  of  channel)  is  tabulated  by 
cross  section.  Table  7-1-4  is  a  partial  list  of  the  data  in  the  output  file  1  (default 
name  PLOTDAT1  .OUT)  for  cross  sections  1  and  5  only. 


Table  7-1-4 

Partial  Listing  of  Plot  Output  File  1  for  Example  Problem  2 


Inlet  1.  Cross  Section  \ 

Total  area  (ft2)  100360.00 

Total  width  (ft)  4264.00 


Channel  -> 

1 

2  3 

4 

Area  (ft2) 

23245.7 

36558.4  9483.8 

31071.7 

Width  (ft) 

912.9 

1708.6  288.0 

1354.5 

Depth  (ft) 

25.5 

21.4  32.9 

22.9 

Weight 

0.2521 

0.2458  0.2513 

0.2508 

X 

Discharge  (cfs) 

Depths  (ft) 

42.661 

0.015 

5.541 

85.323 

0.209 

16.622 

127.984 

0.894 

25.949 

170.645 

1.029 

27.014 

213.307 

1.029 

27.014 

255.968 

1.029 

27.014 

298.629 

1.029 

27.014 

341.291 

1.029 

27.014 

4 

4 

4 

4138.152 

0.235 

18.009 

4180.813 

0.204 

17.128 

4223.474 

0.055 

10.712 

4266.135 

0.004 

3.334 

(Table  7- 

-1-4  Continued 

on  the  Next  Page) 
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(Example  2  Output  Continued) 


(Table  7-1-4  Concluded) 
Inlet  1  Cross  Section  5 


Total  area  (ft2) 
Total  width  (ft) 

Channel  -> 

60112.00 

3744.00 

1 

2 

3 

4 

Area  (ft2) 

22912.5 

6873.2 

5186.1 

25139.6 

Width  (ft) 

1507.7 

325.9 

155.5 

1754.9 

Depth  (ft) 

15.3 

24.3 

34.0 

14.7 

Weight 

0.2850 

0.3649 

0.0600 

0.2901 

X 

Discharge  (cfs) 

Depths  (ft) 

37.459 

0.002 

1.982 

74.917 

0.024 

5.946 

112.376 

0.087 

9.810 

149.835 

0.117 

11.006 

187.294 

0.117 

11.006 

224.752 

0.117 

11.006 

262.211 

0.117 

11.006 

299.670 

0.117 

11.006 

337.129 

0.119 

11.087 

374.587 

0.130 

11.427 

Jl 

1 

4 

3633.498 

0.090 

10.005 

3670.956 

0.064 

8.773 

3708.415 

0.017 

5.225 

3745.874 

0.020 

1.626 

Summary  of  Friction  Losses 


Section 


1 

2 

3 

4 

5 


Friction  Loss/ft  of  Channel 
Length  (dimensionless) 

43.992 

2.460 

14.245 

3.332 

35.970 
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(Example  2  Output  Continued) 

Plot  Output  File  2 


This  file  (Table  7-1-5,  default  name  PLOTDAT2.0UT)  contains  a  table  of 
velocity  hydrographs  produced  by  the  simulation  at  selected  flow  net  cell  locations. 
The  velocities  (feet  per  second)  are  reported  at  the  Tabular  Output  Time  Interval 
and  represent  the  velocity  condition  at  the  centers  of  the  selected  flow  net  cells. 
Figure  7-1-10  is  a  velocity  hydrograph  at  cell  (1,2,2)  of  the  inlet. 


Table  7-1-5 

Listing  of  Plot  Output  File  2  for  Example  Problem  2 


Hour 

(1,2,2) 

(1,2,1) 

(1,2,3) 

(1,2,4) 

0.50 

-6.26 

-2.48 

-6.39 

-1.53 

1.00 

-5.81 

-2.30 

-5.93 

-1.42 

1.50 

-4.52 

-1.79 

-4.61 

-1.10 

2.00 

-2.87 

-1.14 

-2.93 

-0.70 

2.50 

-0.70 

-0.28 

-0.72 

-0.17 

3.00 

2.10 

0.83 

2.14 

0.51 

3.50 

3.22 

1.28 

3.28 

0.79 

4.00 

3.56 

1.42 

3.63 

0.88 

A 

A 

1 

A 

A 

34.50 

4.90 

1.99 

5.00 

1.25 

35.00 

4.85 

1.97 

4.94 

1.24 

35.50 

4.79 

1.95 

4.88 

1.23 

36.00 

4.64 

1.89 

4.74 

1.19 

36.50 

4.49 

1.83 

4.58 

1.16 

37.00 

4.25 

1.74 

4.34 

1.10 

37.50 

3.96 

1.62 

4.04 

1.02 

38.00 

3.57 

1.46 

3.64 

0.92 

Figure  7-1-10.  Velocity  Hydrograph  at  Cell  (1,2,2) 
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(Example  2  Output  Continued) 
Plot  Output  File  3 


This  file  contains  elevation  and  discharge  hydrographs  for  the  sea  boundary 
conditions,  bay,  and  inlet(s).  Results  are  tabulated  at  the  Tabular  Output  Time 
Interval  and  represent  summary  conditions  at  the  indicated  times  for  the  entire 
system.  Included  in  the  file  are  sea  and  bay  elevations,  riverine  inflows,  average 
velocity  at  the  controlling  cross  section,  and  inlet  discharge.  Also  included  in 
the  file  is  a  summary  of  flood  and  ebb  regimes  and  volumes  identified  during 
the  simulation.  Table  7-1-6  is  a  partial  listing  of  data  contained  in  plot  output 
file  3  (default  name  PL0TDAT3.0UT).  Figures  7-1-11  through  7-1-13  are 
hydrograph  plots  of  these  parameters. 


Table  7-1-6 

Partial  Listing  of  Plot  Output  File  3  for  Example  Problem  2 


Time 

Sea  El 

Bay  El 

Riverine 

Controlling 

Inlet  Q 

(hr) 

(ft) 

(ft) 

Inflow 

Section 

(cfs) 

(cfs) 

Vel 

(cfs) 

0.50 

-0.49 

-0.08 

0.00 

-2.83  - 

121489.60 

0.60 

-0.49 

-0.10 

0.00 

-2.87  - 

123317.00 

1.00 

-0.47 

-0.20 

0.00 

-2.62  - 

112561.60 

1.50 

-0.43 

-0.30 

0.00 

-2.04 

-87524.16 

2.00 

-0.37 

-0.37 

0.00 

-1.30 

-55659.24 

2.50 

-0.30 

-0.41 

0.00 

-0.32 

-13664.77 

2.63 

-0.28 

-0.41 

0.00 

0.02 

745.18 

3:00 

-0.22 

-0.39 

0.00 

0.95 

40848.79 

3.50 

-0.12 

-0.34 

0.00 

1.45 

62900.23 

4.00 

-0.02 

-0.27 

0.00 

1.61 

69955.90 

1 

1 

4 

l 

1 

1 

35.50 

1.53 

1.10 

0.00 

2.19 

101222.60 

36.00 

1.60 

1.20 

0.00 

2.32 

98549.31 

36.50 

1.67 

1.30 

0.00 

2.05 

95617.21 

37.00 

1.72 

1.39 

0.00 

1.95 

90929.11 

37.50 

1.76 

1.48 

0.00 

1.81 

84919.09 

38.00 

1.78 

1.56 

0.00 

1.63 

76627.07 

Inlet  1 

Start  Time 

End  Time 

Volume 

(ft3xl000) 

Ebb 

0.03 

2.60 

-735969.80 

Flood 

2.63 

15.67 

4240797.00 

Ebb 

15.70 

26.43 

-4078206.00 

Flood 

26.47 

38.50 

3528005.00 
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Seaward  Uater  Level 
Bay  Water  Level 


Figure  7-1-11.  Sea  and  Bay  Water  Elevations  at  Inlet  1 


Figure  7-1-12.  Average  Velocity  at  Controlling  Cross  Section 
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(Example  2  Output  Continued) 


Figure  7-1-13.  Inlet  Discharge 
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The  following  pages  contain  the  miscellaneous  appendices  referenced  in  the  main 
body  of  the  User’s  Guide.  Appendix  A  consists  of  various  tables  of  coefficients, 
grain-size  classifications,  and  tidal  constituents.  Appendix  B  describes  the  target 
hardware  environment  and  instructions  for  installing  this  version  of  ACES. 
Appendix  C  contains  instructions  for  using  the  graphics  options.  Appendix  D 
is  a  table  listing  the  input  and  output  options  of  the  applications  in  this  version 
of  ACES. 
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Table  A-l 


Kj)  Valuea  for  Use  in  Determining  Armor  Unit  Weight  (Source:  EM  1110-2-2904) 

Structure  Trunk® 

Structure  Head 

Armor  Units 

n® 

Placement 

Breaking 

Wave 

Nonbreaking 

Wave 

Breaking 

Wave 

Nonbreaking 

Wave 

Slope 
cot  0 

Quarrystone 

Smooth  rounded 

2 

Random 

1.2® 

2.4 

1.1® 

1.9 

1. 5-3.0® 

Smooth  rounded 

>3 

Random 

1.6® 

3.2® 

1.4® 

2.3® 

1. 6-3.0® 

Rough  angular 

1 

Random® 

- (3) 

2.9® 

— -<s; 

2.3® 

1.5-S.0® 

Rough  angular 

2 

Random 

2.0 

4.0 

3.2 

2.8 

2.3 

1.5 

2.0 

3.0 

Rough  angular 

>3 

Random 

2.2® 

4.5® 

2.1® 

4.2® 

1. 5-3.0® 

Rough  angular 

2 

Special® 

5.8 

7.0 

6.3® 

6.4 

1. 5-3.0® 

Parallelepiped® 

2 

K755M 

7.0  -  20.0 

8.5  -  24.0® 

--- 

... 

1. 0-3.0 

Tetrapod 

and 

Quadripod 

2 

Random 

7.0 

m 

Km 

6.0 

5.5 

4.0 

1.5 

2.0 

3.0 

Tribar 

2 

Random 

9.0® 

10.0 

8.3® 

7.8® 

6.0 

9.0 

8.5 

6.5 

1.6 

2.0 

3.0 

Doles 

2 

Random 

15.0® 

31.0® 

8.0® 

7.0 

16.0® 

14.0® 

2.0® 

S.O 

Modified  cube 

2 

Random 

6.5® 

7.5 

--- 

5.0® 

1. 6-3.0® 

Hexapod 

2 

Random 

8.0® 

9.5 

5.0® 

7.0® 

1.5 -3.0® 

Toskane 

2 

Random 

11.0® 

22.0 

— 

— 

1. 5-3.0® 

Tribar 

1 

Uniform 

12.0 

15.0 

7.5® 

9.5® 

1. 6-3.0® 

Quarrystone  -  graded 
angular  riprap 

H 

Random 

2.2 

2.5 

... 

... 

—  - 

(1 1  CAUTION:  These  Kn  values  are  unsupported  and  are  urovided  only  for  preliminary  design. 

(2)  n  is  the  number  of  unitB  comprising  the  thickness  of  the  armor  layer. 

(3)  The  use  of  single  layer  of  quarrystone  armor  units  is  not  recommended  for  structures  subject  to  breaking  waves, 

and  only  under  special  conditions  for  structures  subject  to  nonbreaking  waves.  When  it  is  used,  the  stone 
should  be  carefully  placed. 

(4)  Special  placement  with  long  axis  of  stone  placed  perpendicular  to  structure  face. 

(5)  Stability  of  dolosse  on  slopes  steeper  than  1  on  2  should  be  substantiated  by  site-specific  tests. 

(S)  Refers  to  no-damage  criteria  (<5  percent  displacement,  rocking,  etc.);  if  no  rocking  (<2  percent)  is  desired,  reduce 

Kj)  50  percent  (Zwamborn  and  Van  Niekerk,  1982). 

17)  Applicable  to  slopes  ranging  from  1  on  1.5  to  1  on  5. 

(B)  Until  more  information  is  available,  the  use  of  Kq  should  be  limited  to  slopes  ranging  from  1  on  1.5  to  1  on  3. 

Some  armor  units  tested  on  a  structure  head  indicate  a  Kq -slope  dependence. 

(9)  Parallelepiped-shaped  Btone:  long  slab -like  stone  with  long  dimension  approximately  three  times  the  shortest 

dimension  (Markle  and  Davidson,  1979). 
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Table  A-2 


Layer  Coefficient  and  Porosity  for  Various  Armor  Units  (Source'.  SPM) 


Armor  Unit 

n 

Placement 

Layer  Coefficient 

Porosity  % 

Quarrystone  (smooth) 

2 

Random 

1.02 

38 

Quarry  stone  (rough) 

2 

Random 

1.00 

37 

Quarrystone  (rough) 

>3 

Random 

1.00 

40 

Quarrystone  (parallelepiped) 

2 

Special 

- 

27 

Cube  (modified) 

2 

Random 

1.10 

47 

Tetrapod 

2 

Random 

1.04 

50 

Quadripod 

2 

Random 

0.05 

40 

Hexipod 

2 

Random 

1.15 

47 

Tribar 

2 

Random 

1.02 

54 

Dolos 

2 

Random 

0.94 

56 

Toskanc 

2 

Random 

1.03 

52 

Tribar 

1 

Uniform 

1.13 

47 

Quarrystone 

Graded 

Random 

- 

37 

Table  A-3 


Rough  Slope  Run-Up  Coefficients  (Source:  Smith,  1986) 

Armor  Material 

a 

b 

Riprap 

0.956 

0.398 

Rubble  (Permeable  -  No  Core) 

0.692 

0.504 

Rubble  (2  Layers  -  Impermeable  Core) 

0.775 

0.361 

Modified  Cubes 

0.960 

0.690 

Tetrapods 

1.010 

0.910 

Quadripod: 

0.590 

0.350 

Hexapods 

0.820 

0.630 

Tribars 

1 .810 

1.570 

Doloase 

0  988 

0.703 
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Table  A-4 


Grain-Size  Scales  (Soil  Classification) 


r 

Unified  Soils 

ASTM 

PHI 

MM 

Wentworth 

I  Classification 

Mesh 

Classification 

-a.  oo 

256.00 

Cobble 

-7.00 

129.00 

-6.75 

107.60 

Cobble 

-9.50 

90.51 

*8.25 

■9.00 

64  00 

-5  76 

53.82 

Coarse  Gravel 

-5.50 

45.26 

G 

-5.25 

33.06 

-S.00 

3200 

R 

-4.75 

2691 

•4.50 

-4.25 

22.93 

19.00 

A 

-4.00 

19.00 

Pebble 

V 

-3.75 

13.45 

Fine  Gravel 

-3.50 

11.31 

E 

-3.25 

9.51 

2.5 

-3.00 

e.oo 

L 

3 

-2.75 

6  73 

3.5 

-2.60 

-2.25 

-2.00 

5.66 

4,76 

4,00 

Coarse 

6 

7 

8 

10 

-1.75 

-1.50 

-1.25 

-1.00 

3.36 

2.63 

238 

2.00 

Granule 

12 

-0.75 

1.68 

Medium 

14 

16 

16 

*0.50 
-0  25 

0.00 

1.41 

1.19 

1.00 

Very  Course 

20 

0.25 

0  84 

A 

N 

25 

30 

35 

0.50 

0.75 

1.00 

0.71 

0.59 

0.50 

Coarse 

S 

40 

1.25 

042 

D 

45 

50 

60 

1.50 

1.75 

2.00 

0.35 

0.30 

0.25 

Medium 

N 

70 

2.25 

0.21 

D 

Fine 

80 

100 

120 

2.50 

275 

3.00 

0.177 

0.149 

0.125 

Fine 

140 

3.25 

0.105 

170 

200 

230 

3.50 

3.75 

4.00 

0068 

0.074 

0.0625 

Very  Fine 

270 

4.25 

0.0526 

325 

4.50 

0.0442 

Silt 

400 

4.75 

0.0372 

Silt 

M 

5.00 

0.0313 

6.00 

7.00 

800 

0.0156 

0.0078 

0.0039 

U 

900 

0.0020 

Clay 

10.00 

0.0009 

Clay 

_ 

12.00 

0.0002 
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Table  A- 5 


Major  Tidal  Constituents 

Symbol 

Constituent  Name 

Frequency 

(degrees/hour) 

M2 

Lunar  semidiurnal 

28.984 

s2 

Principal  solar  semidiurnal 

30.000 

n2 

Larger  lunar  elliptic  semidiurnal 

28.439 

Ki 

Lunisolar  diurnal 

15.041 

M4 

Shallow-water  overtide  of  principal  lunar 

57.968 

Oi 

Principal  lunar  diurnal 

13.943 

m6 

Shallow-water  overtide  of  principal  lunar 

86.952 

mk3 

Shallow-water  compound 

44.025 

S4 

Shallow-water  overtide  of  principal  solar 

60.000 

MN4 

Shallow-water  compound 

57.423 

v2 

Larger  lunar  evectional 

28.512 

S6 

Shallow-water  overtide  of  principal  solar 

90.000 

m2 

Variational 

27.968 

2N2 

Lunar  elliptic  semidiurnal  (second  order) 

27.895 

OOj 

Lunar  diurnal  (second  order) 

16.139 

\2 

Smaller  lunar  evectional 

29.455 

Si 

Solar  diurnal 

15.000 

Mi 

Smaller  lunar  elliptic  diurnal 

14.496 

Jl 

Smaller  lunar  elliptic  diurnal 

15.585 

Mm 

Lunar  monthly 

0.544 

Ssa 

Solar  semidiurnal 

0.082 

Solar  annual 

0.041 

M8f 

Lunisolar  synodic  fortnightly 

1.015 

Mf 

Lunar  fortnightly 

1.098 

pl 

Larger  lunar  evectional  diurnal 

13.471 

Qi 

Larger  lunar  elliptic  diurnal 

13.398 

t2 

Larger  solar  elliptic 

29.958 

R2 

Smaller  solar  elliptic 

30.041 

2Qi 

Lunar  elliptic  diurnal  (second  order) 

12.854 

Pl 

Solar  diurnal 

14.958 

2SM2 

Shallow-water  compound 

31.015 

M3 

Lunar  terdiurnal 

43.476 

l2 

Smaller  lunar  elliptic  semidiurnal 

29.528 

2MK3 

Shallow-water  compound 

42.927 

K2 

Lunisolar  semidiurnal 

30.082 

Mg 

Shallow-water  overtide  of  principal  lunar 

115.936 

MS4 

Shallow-water  compound 

58.984 
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Hardware 


B  -  Hardware  and  Installation 


The  Automated  Coastal  Engineering  System 
(ACES)  is  designed  to  run  on  IBM  PC-AT  (or 
compatible)  machines  having  the  following 
configuration: 

640  Kb  memory 

80287  math  co-processor 

The  screen  displays  in  ACES  are  designed  in 
color.  A  color  adaptor  and  monitor  (VGA, 
EGA,  PGA,  or  CGA)  are  preferable.  Some 
monochrome  display  adaptors  and  monitors  will 
also  work.  A  printer  is  preferable,  but  not 
required. 


Tables  B-l  through  B-3  list  the  hardware  devices  (graphics  adaptors,  printers, 
and  plotters)  that  are  supported  by  the  graphics  software. 


Table  B-l.  Supported  Graphics  Adaptors 
(Resolution  and  Colors) 

Color  Graphics  Adaptor  (CGA) 

Enhanced  Graphics  Adaptor  (EGA) 

Monochrome  Display  (640  x  350;  4  colors) 

Color  Display  (640  x  200;  16  colors) 

Enhanced  Color  Display  (640  x  200;  16  colors) 

NEC  GB-1  with  Multi-Frequency  Monitor  (640  x  480;  16/04  colors) 

EVEREX  EVGA  with  Multi-Frequency  Monitor  (800  x  600;  16/64  colors) 

Video  Graphics  Adaptor  (VGA) 

Analog  Monitor  (640  x  480;  16/256  colors) 

Video  7  with  Multi -Frequency  Analog  Monitor  (720  x  640;  16/256  colors) 

Video  7  with  Multi-Frequency  Analog  Monitor  (800  x  600;  16/256  colors) 

ORCHID/GENOA  with  Multi-Frequency  Analog  Monitor  (800  x  600;  16/256  colors) 

AST/PARADISE  with  Multi-Frequency  Analog  Monitor  (800  x  600;  16/256  colors) 

Other  Graphics  Adaptors 

Hercules  (720  x  348;  2  colors) 

COMPAQ  Portable  III  with  Gas  "Plasma  Display  (640  x  400;  2  colors) 
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Table  B-2.  Supported  Printers 
IBM  Graphics 
Epson  FX/RX  Series 
HP  LaserJet 
HP  PaintJet 


Table  B-3.  Supported  Plotters 
HP-Compatible  2-Pen  Plotter 
HP-Compatible  6-Pen  Plotter 
HP -Compatible  8-Pen  Plotter 


Installation 


Installation  of  this  version  of  ACES  requires  installing  ACES  in  a  specified 
directory  and  customizing  the  graphics  setup.  The  next  two  sections  describe 
these  installation  procedures. 


ACES  Software  Installation 

The  ACES  software  is  distributed  on  one  high-density  (1.2-Mb)  diskette.  To 
install  ACES  on  a  hard  disk  requires  creating  a  directory  where  ACES  will  reside, 
and  de-archiving  the  files  on  the  ACES  diskette  to  that  directory.  These  steps 
are  detailed  below. 


1.  Use  the  DOS  MD  or  MKDIR  command  to  create  a  subdirectory  in  which 
the  ACES  files  will  reside.  The  example  below  assumes  that  the 
subdirectory  will  be  called  ACES107  and  will  be  a  subdirectory  of  the 
root  directory  on  the  C:  drive. 


CD  C:\  (go  to  the  root  directory) 

MD  C:\ACES107  (  ENTER")  (create  a  new  directory  called  ACES107) 

CD  \ACES107  [  ENTER  )  (move  into  the  new  directory) 
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2.  Insert  the  ACES  disk  in  Drive  A  and  type: 

A:PKXARC  A:*. ARC  I  ENTER  ) 

ACES  will  now  be  installed  in  subdirectory  ACES107.  Refer  to  the 
section  of  Appendix  B  titled  Graphics  Software  Installation  for 
instructions  for  installing  the  ACES  graphics  capability. 


3.  Any  last-minute  changes  or  additions  to  the  ACES  Program  are 
documented  in  a  file  called  README.  Review  this  file  and  make  note 
of  any  changes.  To  display  the  README  file,  type: 

TYPE  README  |  MORE  |  ENTER  1 


4.  For  ACES  to  run  properly,  the  configuration  file  CONFIG.SYS  must 
contain  the  following  two  statements: 

FILES=n 

BUFFERS=n 

where  n  is  greater  than  or  equal  to  20.  If  n  is  less  than  20,  edit  the 
CONFIG.SYS  file  and  reboot  DOS. 


5.  To  run  the  ACES  program,  type: 
ACES  ( ENTER ) 
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Graphics  Software  Installation 

The  graphics  capabilities  of  this  version  of  ACES  must  be  installed  with  a  special 
program  called  INSTALL.COM.  The  following  section  provides  an  example 
installation  using  the  program  INSTALL.COM. 


Example  of  Graphics  Software  Installation 

A  typical  interactive  session  for  INSTALL.COM  is  described  below.  Please  note 
that  all  user  responses  are  highlighted  in  boldface  type.  Standard  default  options 
(inside  brackets  [  ])  can  be  selected  by  pressing  [  enter  ]  from  the  keyboard. 
This  example  installation  assumes  the  following  configuration  to  be  installed: 

°  Enhanced  Graphics  Adaptor  (EGA) 

°  Resolution  (640  x  350) 

°  Supporting  16  colors 

°  Plotter  Type  -  HP  compatible  8-pen  plotter  (COM1:) 

6  Printer  Type  -  Hewlett  Packard  (HP)  Laser  jet  (LPT1:) 


The  graphics  software  may  be  installed  by  following  these  steps  (user  responses 
are  highlighted  in  boldface  type): 


1.  C:\ACES 1 07>  INSTALL  (  ENTER  ) 


2.  Enter  the  code  for  the  display  adaptor  that  matches  your  system: 

0)  Monochrome  Display  Adaptor  (No  graphics) 

1)  Color  Graphics  Adaptor  (CGA) 

2)  Enhanced  Graphics  Adaptor  (EGA) 

3)  Video  Graphics  Adaptor  (VGA) 

4)  Other 

Enter  selection  [1]  ....  2  [  enter  ] 
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3. 


Enter  the  code  for  the  EGA  and  display  monitor  that  matches  your 
system: 

Resolution  and  Colors 

0)  Return  to  previous  menu 


1)  Enhanced  Graphics  Adaptor  640  x  350  x  4 

w/  Monochrome  Display 

2)  Enhanced  Graphics  Adaptor  640  x  200  x  16 

w/  Color  Display 

3)  Enhanced  Graphics  Adaptor  640  x  200  x  16 

w/  Enhanced  Color  Display,  64K 

4)  Enhanced  Graphics  Adaptor  640  x  350  x  16/64 

w/  Enhanced  Color  Display,  >64K 

5)  NEC  GB-1  EGA  640  x  480  x  16/64 

w/  multi-frequency  monitor 

6)  Everex  EVGA  800  x  600  x  16/64 

w/  multi-frequency  monitor 

Enter  selection  [0]  ....  4  [  enter  ] 


4.  Select  a  pen  plotter: 

0)  No  Plotter 

1)  HP-compatible  2-pen  plotter 

2)  HP-compatible  6-pen  plotter 

3)  HP-compatible  8-pen  plotter 
Enter  selection  [0]  ....  3  f  enter  ) 


5.  Select  a  graphics  printer: 

0)  No  Printer 

1)  IBM  Graphics 

2)  Epson  FX/RX  Series 

3)  HP  LaserJet 

4)  HP  PaintJet 

Enter  selection  [1]  ....  3  (  enter  ) 
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6.  Select  plotter  port: 

1)  COM1:  2)  COM2:  3)  LPT1:  4)  LPT2:  5)  LPT3: 
Enter  selection  [1]  ....  1  [  enter  ] 


7.  Select  printer  port: 

1)  LPTI:  2)  LPT2:  3)  LPT3: 

Enter  selection  [1]  ....  1  [  enter  1 

Please  wait  ... 

Finished  installing  ACES.EXE  &  INSTALL  4.5. ..21  Nov  1989 

NOTE:  Before  sending  graphics  to  a  plotter,  be  sure  to  type 
MODE  COMl:(rate),n,8,l,p 

where  (rate)  is  the  baud  rate  to  which  the  plotter  is  set  with 
the  switches  on  the  rear  panel. 
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Introduction 

A  simple  graph  often  can  reveal  information  that  is  not  immediately  apparent 
in  a  table.  The  Automated  Coastal  Engineering  System  (ACES)  has  the  capability 
to  instantly  create  and  modify  graphs  for  certain  applications.  This  appendix 
of  the  User's  Guide  describes  how  to  create,  customize,  and  print  graphs.  For 
installation  of  the  graphics  capability,  see  Appendix  B. 


Main  Graphics  Options  Menu 

For  ACES  applications  providing  graphics  capabilities,  the  Main  Graphics  Options 
Menu  appears  at  the  bottom  of  the  screen  below  each  plot.  The  current  option 
is  highlighted  for  identification.  Options  may  be  accessed  by  using  the  (<3  and 
©  keys  from  the  keyboard.  Options  may  also  be  accessed  by  typing  the  first 
letter  of  the  option  name.  The  graphics  software  also.supports  a  mouse  (Microsoft 
Mouse  compatible),  which  can  be  used  as  an  input  device.  The  main  graphics 
options  available  are  shown  in  Table  C-l.  A  description  of  each  option  (and 
suboptions)  is  given  in  the  sections  that  follow. 


Table  C-l.  Graphics  Options 

Option 

Description 

Default 

Seal 

AUTOMATIC  or  USER-DEFINED  SCALING 

Automatic 

Grid 

GRID  AXIS  Toggle  Switch 

tic  axis 

Coir 

Change  COLOR  of  Each  Curve 

Dump 

SCREEN  DUMP  to  Installed  Printer 

Styl 

Change  LINE  &  MARKER  STYLES  of  Each  Curve 

Solid  Line 

Legn 

Relocate  the  LEGEND 

Axis 

AXIS  TYPE  -  Linear/Log 

Linear 

Read 

READ  POINTS  from  the  Selected  Curve 

Devi 

Select  OUTPUT  DEVICE  -  Screen,  Plotter,  HPGL  file 

Screen 

Wind 

WINDOW  the  Current  Plot 

All 

Zero 

ZERO  LINE  DISPLAY  Toggle  Switch 

Next 

NEXT  Plot 

Quit 

Return  to  Current  ACES  Application 
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Seal 

Automatic  (computer-generated)  or  user-defined  scaling  may  be  selected  for  the 
current  display.  Suboptions  available  under  Seal  are: 


(a)  Automatic  -  This  is  the  default  case.  Minimums  and  maximums 
are  computed  for  both  X  and  Y  from  the  data  selected  for  plotting. 
These  values  (xmin,  xmax,  ymin,  ymax)  become  the  window  for  the 
current  display. 


(b)  User-Defined  -  A  user-defined  scale  may  be  selected.  The 
current  minimum  and  maximum  values  for  both  X  and  Y  are 
displayed  (inside  parentheses)  at  the  bottom  of  the  screen.  These 
may  be  changed  to  new  values  or  selected  with  a  carriage  return  to 
accept  the  current  value  shown.  The  revised  plot  is  then  displayed. 


(c)  Ret  -  Program  control  is  returned  to  the  Main  Graphics  Options 
Menu. 


Grid 

This  option  allows  switching  (toggling)  between  tic  axes  (the  default)  and  grid 
generated  axes  for  the  plot.  Since  the  default  plot  uses  tic  axes,  the  first  time 
this  option  is  selected,  grid  axes  will  be  generated  for  both  the  X-  and  Y-axes. 
Again  selecting  this  option  returns  the  axis  to  the  default  or  tic  axes  display. 


NOTE:  The  selected  axis  type  remains  in  effect  for  all 
subsequent  plots  for  a  particular  application  unless 
changed  with  this  option. 
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Coir 

The  color  of  each  curve  on  the  display  can  be  changed.  Coir  options  are  displayed 
across  the  bottom  of  the  screen.  Suboptions  available  under  Coir  are: 

(a)  -  0,1, 2,. ..,15  -  These  numbers  represent  colors  supported  by 
this  graphics  software.  The  color  name  for  each  number  is  displayed 
in  the  lower  left  corner  of  the  screen  just  above  the  numbers. 

NOTE:  If  a  color  is  not  supported  by  the  graphics 
adapter  (see  Table  B-l  in  Appendix  B),  the  curve  will 
retain  its  original  color.  The  color  black  can  be  used 
to  blackout  or  temporarily  delete  a  particular  curve. 

(b)  -  Pit  -  Replot  the  graph  after  changes  have  been  made. 

(c)  -  Ret  -  Control  is  returned  to  the  Main  Graphics  Options  Menu. 

The  GD  and  ED  keys  are  used  to  move  the  highlighted  box  to  the  number 
representing  the  desired  color.  Press  (  enter  )  to  select  the  highlighted  color  for 
the  curve.  This  process  can  be  repeated  for  the  remaining  curves  on  the  graph. 
The  suboption  Pit  will  replot  the  graph  with  the  new  color  selections. 

NOTE:  The  curve  that  is  to  be  changed  is  identified  in 
the  upper  left  corner  of  the  screen,  and  its  current  color 
number  is  highlighted  at  the  bottom  of  the  screen.  Press 
[  enter  )  if  no  change  in  the  curve  color  is  desired. 


Dump 

A  screen  image  of  the  current  display  (without  the  Main  Graphics  Options  Menu) 
is  sent  to  the  installed  printer.  Program  control  is  temporarily  suspended  until 
printing  is  completed. 

NOTE:  If  no  printer  has  been  installed,  a  message  will 
be  displayed  at  the  bottom  of  the  screen.  Press  [  enter  1 
to  return  to  the  Main  Graphics  Options  Menu. 
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The  Line  Styles  and/or  Marker  Types  of  each  curve  on  the  current  display  can 
be  changed.  The  suboptions  available  under  Styl  are  displayed  across  the  bottom 
of  the  screen.  Suboptions  are: 

(a)  Line  Styles  -  0,1,2,...,6  -  These  numbers  represent  the  Line 
Styles  supported  by  this  graphics  software.  A  Line  Styles  description 
for  each  number  is  displayed  in  the  lower  left  corner  of  the  screen 
just  above  the  numbers.  The  Line  Styles  supported  are: 

0  -  No  Line  (Points  Only) 

1  -  Solid  Line  (Default) 

2  -  Long  Dashed  Line 

3  -  Dotted  Line 

4  -  Dashed  Dotted  Line 

5  -  Medium  Dashed  Line 

6  -  Dash  Dot  Dot  Line 

Ret  -  Program  control  is  returned  to  the  Styl  Options 
Menu. 

The  0  and  £E)  keys  are  used  to  move  the  highlighted  box  to  the 
desired  Line  Styles  number.  Press  1  enter  1  to  select  the  highlighted 
Line  Style.  This  process  can  be  repeated  for  the  remaining  curves 
on  the  graph.  The  suboption  Pit  will  replot  the  graph  with  the  new 
Line  Styles.  The  suboption  Ret  will  return  to  the  Styl  Options  Menu. 

NOTE:  The  curve  that  is  to  be  affected  by  the  Line 
Styles  change  is  identified  in  the  upper-left  corner  of 
the  screen,  and  its  current  Line  Style  number  is 
highlighted  at  the  bottom  of  the  screen.  Press  [enter  1 
if  no  change  in  the  curve  Style  is  desired. 


(b)  Marker  Types  -  -  These  numbers  represent  the  Marker 

Types  supported  by  this  graphics  software.  A  Marker  Types 
description  for  each  number  is  displayed  in  the  lower-left  corner  of 
the  screen  just  above  the  numbers.  The  Marker  Types  supported 
are: 


0  -  No  Marker  (Default) 
1  -  Dot 
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2  -  Cross 

3  -  Star 

4  -  Square 

5  -  X 

6  -  Diamond 

Ret  -  Program  control  is  returned  to  the  Styl  Options 
Menu. 

The  ©  and  EE)  keys  are  used  to  move  the  highlighted  box  to  the 
desired  Marker  Types  number.  Pressing  [  enter  )  will  select  the 
highlighted  Marker  Types.  This  process  can  be  repeated  for  the 
remaining  curves  on  the  graph.  The  suboption  Pit  will  replot  the 
graph  with  the  new  Marker  Types.  The  suboption  Ret  will  return 
to  the  Styl  Options  Menu. 

NOTE:  The  curve  that  is  to  be  affected  by  the  Marker 
Types  change  is  identified  in  the  upper-left  corner  of 
the  screen  and  its  current  Marker  Type  number  is 
highlighted  at  the  bottom  of  the  screen.  Press  [enterJ 
if  no  change  in  the  curve  Marker  is  desired. 


(c)  Pit  -  Replot  the  graph  after  changes  have  been  made. 


(d)  Ret  -  Program  control  is  returned  to  the  Main  Graphics  Options 
Menu. 


Legn 

The  legend  may  be  moved  to  any  position  on  the  current  display.  When  this 
option  is  selected,  cross  hairs  appear  on  the  screen  at  the  upper-left  corner  of 
the  legend.  The  arrow  keys  may  be  used  to  position  the  cross  hairs  at  a  new 
location.  Press  [enter  )  to  display  the  revised  plot. 

NOTE:  The  new  legend  position  remains  in  effect  for 
all  remaining  plots  of  the  current  application  unless 
changed  with  this  option. 
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Axis 

This  option  allows  the  flexibility  of  switching  to  logarithmic  or  linear  coordinate 
systems  for  the  selected  data. 

NOTE:  If  the  data  contain  negative  values  which  cannot 
be  scaled  into  logarithmic  coordinates,  a  message  will 
appear  on  the  screen  stating  that  no  logarithmic  axis  can 
be  drawn.  The  resulting  plot  is  then  displayed  with  a 
linear  coordinate  system  (default). 

Suboptions  available  under  Axis  are: 

(a)  Lin  X-Lin  Y  -  This  is  the  default  case.  The  coordinate  system 

is  linear  for  both  the  X-  and  Y-axes. 

(b)  Lin  X-Log  Y  -  The  coordinate  system  is  linear  for  the  X-axis 

and  logarithmic  (base  10)  for  the  Y-axis. 

(c)  Log  X-Lin  Y  -  The  coordinate  system  is  logarithmic  (base  10) 

for  the  X-axis  and  linear  for  the  Y-axis. 

(d)  Log  X-Log  Y  -  The  coordinate  system  is  logarithmic  (base  10) 

for  both  the  X-  and  Y-axes. 

(e)  Ret  -  Program  Control  is  returned  to  the  Main  Graphics  Options 

Menu. 


Read 

This  option  displays  the  estimated  y  value  for  a  corresponding  x  value  for  each 
curve.  At  the  prompt,  an  x  value  is  entered  that  is  bounded  by  the  window  of 
the  current  display  (xmin  <  x  <  xmax).  The  estimated  y  value  is  displayed  at 
the  bottom  of  the  screen.  Each  selected  (x,y)  pair  is  marked  on  its  corresponding 
curve  by  an  x.  Press  (.enter  )  to  return  program  control  to  the  Main  Graphics 
Option  Menu. 

NOTE:  If  an  x  value  that  is  not  inside  the  window  of 
the  current  display  is  selected,  a  message  is  displayed  at 
the  bottom  of  the  screen  stating  that  the  entered  x  value 
is  out  of  range.  Press  Center  ]  to  re-display  the  plot  and 
return  to  the  Main  Graphics  Options  Menu. 
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Devi 

This  option  selects  a  specific  output  device  to  which  the  current  display  will  be 
sent.  Suboptions  available  under  Devi  are: 

(a)  Screen  -  This  is  the  default  case.  The  selected  plot  will  be 
displayed  on  the  installed  graphics  display. 

(b)  Plotter  -  The  plot  will  be  sent  to  the  installed  plotter. 

NOTE:  Program  control  is  suspended  until  the  plotter 
has  stopped.  If  no  plotter  has  been  installed,  a  message 
will  be  displayed  requesting  that  the  INSTALL  program 
be  run  to  configure  the  proper  hardware  setup.  The 
ACES  program  will  be  terminated,  and  control  will  be 
returned  to  the  DOS  prompt. 

(c)  Plot  File  -  The  plot  will  be  sent  to  a  plot  file  for  processing  at 
a  later  time.  The  plot  file  is  named  xxxx.PLT,  where  xxxx  is  a 
4-digit  number  beginning  with  0000.  Any  subsequent  plots  sent  to 
this  device  are  named  0001. PLT,  0002. PLT,  etc.  These  plot  files 
arc  IIP  compatible  only  and  can  be  postprocessed  upon  completion 
of  the  ACES  interactive  session.  These  files  can  be  copied  to  the 
appropriate  communication  port  where  the  plotter  is  connected  to 
generate  the  plots.  For  example,  to  copy  plot  file  0001. PLT  to  the 
plotter  that  is  connected  to  communication  port  2  (COM2:),  the 
following  is  entered  at  the  DOS  prompt: 

C:\ACES105>  COPY  0001. PLT  COM2:  [  fntfr ) 


NOTE:  The  communication  port  must  be  set  to  coincide 
with  the  plotter’s  baud  rate,  parity,  and  stop  bit  settings 
for  correct  use.  (Third  party  software  is  available  that 
will  translate  these  plot  files  to  an  HP-compatible 
LaserJet  Series  printer.) 

(d)  Ret  -  Program  Control  is  returned  to  the  Main  Graphics  Options 
Menu. 
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This  option  specifies  the  boundaries  and  size  of  the  current  display.  Suboptions 
available  under  Wind  are: 

(a)  All  -  This  is  the  default  case.  The  original  plot  will  be  displayed. 
If  User-Defined  scaling  is  selected  (see  Seal  options  described  above), 
this  becomes  the  default  during  this  option. 


(b)  Window  -  This  option  zooms  in  or  out  on  a  particular  subregion 
of  the  current  display  by  locating  two  opposite  corners  of  a  window 
enclosing  the  desired  region.  When  this  suboption  is  selected, 
crosshairs  are  displayed  in  the  middle  of  the  screen.  The  arrow  keys 
are  used  to  re-locate  the  crosshairs  to  one  corner  of  the  desired 
window.  Press  f  enter  )  to  lock  in  this  position.  The  opposite  corner 
of  the  window  is  similarly  located,  and  the  new  region  is  shown 
bordered  in  a  box.  Press  [  enter  )  to  display  only  the  area  delimited 
by  the  window. 


(c)  Scale  -  A  scale  factor  can  be  entered  to  enlarge  or  shrink  the 
existing  window  in  both  the  X-  and  Y-directions.  For  example,  a 
scale  factor  of  0.5  doubles  the  window  in  both  the  X-  and 
Y-directions.  The  resulting  plot  contains  the  same  data  mapped  into 
a  larger  window  and  gives  the  effect  of  zooming  out  on  the  selected 
data.  Conversely,  zooming  in  is  achieved  by  entering  a  scale  factor 
greater  than  1. 


NOTE:  The  scale  factor  entered  is  applied  to  both  the 
X-  and  Y-coordinate  system  resulting  in: 

Xmin  =  Xmin  /  factor 
Xmax  =  Xmax  /  factor 
Ymin  =  Ymin  /  factor 
Ymax  =  Ymax  /  factor 

(d)  Ret  -  Program  control  is  returned  to  the  Main  Graphics  Options 
Menu. 
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Zero 

This  option  switches  the  optional  display  of  a  zero  line  (y=0.0)  on  the  plot.  The 
zero  line  contains  the  following  two  coordinates:  (xmin,  0.0)  and  (xmax,  0.0). 

NOTE:  If  the  zero  line  is  displayed  on  the  plot,  selecting 
this  option  will  remove  it.  Selecting  it  again  will 
re-display  the  zero  line. 


Next 

This  option  displays  the  next  plot  in  the  series. 

NOTE:  Some  applications  in  ACES  have  multiple  plots. 
If  the  current  application  has  only  one  plot  and  this 
option  is  selected,  the  screen  is  erased  and  the  user  is 
returned  to  the  current  ACES  application. 


Quit 

This  option  terminates  all  graphics  options.  The  screen  is  erased,  and  program 
control  is  returned  to  the  current  ACES  application. 
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NOTE:  S  -  Single  Case  Mode  D  -  Default 

Symbols  are  defined  as  follows;  M  -  Multiple  Case  Mode  O  -  Optional 

-  -  Unavailable 
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In  a  general  procedural  sense,  much  has  been  taken  from  previous  individual 
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